1
0
Fork
You've already forked hackercore
0
No description
  • Moocode 88.3%
  • Mercury 9.6%
  • Shell 1.4%
  • Rust 0.4%
  • Dockerfile 0.3%
2025年09月19日 01:53:30 -06:00
core Add $heart, originally written by jasonsw; add #0:permit permits, originally written for stunt 2025年09月19日 00:14:24 -06:00
vendor Update vendor/moor submodule to latest version 2025年09月13日 01:28:08 +00:00
vms-worker vms worker now compiles and is added to hacker 2025年09月11日 19:24:53 +00:00
.gitignore Ignore the daemon's keypair files 2025年09月17日 10:49:06 -06:00
.gitmodules Add moor as git submodule in vendor/moor 2025年09月10日 23:13:19 +00:00
docker-compose.yml vms worker now compiles and is added to hacker 2025年09月11日 19:24:53 +00:00
Dockerfile vms worker now compiles and is added to hacker 2025年09月11日 19:24:53 +00:00
features.md Add in progress todo / features list 2025年09月19日 01:53:30 -06:00
hacker.sh Excluding main repo from update checks 2025年09月13日 01:37:38 +00:00
README.md Added docker configuration and more 2025年09月11日 00:14:47 +00:00

HackerCORE

MUD Docker Rust

A modern MUD (Multi-User Dungeon) Core built with mooR - the next generation MOO server

What is Hackercore?

HackerCORE is a mooR database built to be the foundation or starting point for future MUDs. Built on the mooR platform, it provides a robust, scalable foundation for interactive fiction and multiplayer text adventures.

Features

  • Feature - When I actually have a feature I should put it here :P

Quick Start

Prerequisites

The hacker.sh script will automatically check for and guide you through installing:

  • Docker - Container runtime
  • Docker Compose - Multi-container orchestration

Running Hackercore

  1. Clone and Navigate

    git clone git@github.com:biscuitWizard/moor-hackercore.git
cd hackercore

  2. Start the MUD

    ./hacker.sh start

  3. Connect and Play

    # Via Telnet (traditional MUD client)
telnet localhost 8888
# Or use any MUD client like:
# - Mudlet
# - TinTin++
# - MUSHclient

The hacker.sh Script

Our custom management script makes running HackerCore incredibly simple:

📋 Available Commands

Command Description
./hacker.sh start Start all HackerCore services
./hacker.sh stop Stop all services
./hacker.sh restart Restart all services
./hacker.sh status Show service status

🔌 Ports

Port Service Description
8888 Telnet Traditional MUD connection
8080 WebSocket Modern web-based connection
7896-7899 Internal Inter-service communication

📁 Project Structure

hackercore/
├── 🎮 hacker.sh # Management script
├── 🐳 docker-compose.yml # Service orchestration
├── 📂 core/ # MUD database objects
│ ├── #0.moo # System objects
│ ├── #1.moo # Root object
│ └── ... # Game objects
├── 📂 vendor/moor/ # mooR server implementation
├── 📂 vms-worker/ # Custom worker processes
└── 📂 db/ # Database storage

Troubleshooting

Common Issues

** "Docker not found"**

  • The script will provide installation instructions for your OS
  • Follow the provided commands to install Docker

** "Docker Compose not found"**

  • The script will guide you through Docker Compose installation
  • Usually just a few commands away

** "Permission denied"**

  • Make sure the script is executable: chmod +x hacker.sh
  • Ensure Docker daemon is running: sudo systemctl start docker

** "Port already in use"**

  • Check what's using the port: netstat -tulpn | grep 8888
  • Stop conflicting services or change ports in docker-compose.yml

Resources

MUD Development

mooR Platform

Community

Acknowledgments

  • LambdaCore - The legendary MUD core database that inspired this project
  • mooR - The modern Rust-based MOO server platform
  • MUD Community - Decades of innovation in text-based gaming

Ready to start your adventure?

./hacker.sh start
telnet localhost 8888

Welcome to HackerCore!