7

Home

houmgaor edited this page 2026-02-18 11:41:31 +01:00

Table of Contents

• What is Erupe?
• Getting Started
• Prerequisites
• 1. Set Up the Database
• 2. Configure
• 3. Build and Run
• Docker Alternative
• Wiki Pages
• Setup & Operations
• Development
• Reference

What is Erupe?

Erupe is a community-maintained server emulator for Monster Hunter Frontier, written in Go. It implements the sign, entrance, and channel servers needed to play the game after Capcom shut down the official servers in December 2019. All code is clean-room reverse-engineered from protocol analysis.

Most core systems are functional: quests, guilds, multiplayer, shops/gacha, mail, character saves, and housing. Some endgame event systems (tournaments, tower) have minimal implementations. See Client Versions for supported game versions (Season 6.0 through ZZ).

Getting Started

Prerequisites

• Go 1.25+
• PostgreSQL (14+ recommended)
• Game client files — legally obtained MHF client (quest/scenario binaries go in bin/)

1. Set Up the Database

Create a PostgreSQL database named erupe, then restore the base schema:

createdb -U postgres erupe
pg_restore -U postgres -d erupe schemas/init.sql

The init.sql is a pg_dump archive (not plain SQL) that bootstraps the schema to v9.1.0.

Then apply patch schemas in numerical order:

psql -U postgres -d erupe -f schemas/patch-schema/00-psn-id.sql
psql -U postgres -d erupe -f schemas/patch-schema/01-wiiu-key.sql
# ... continue through all patches

Optionally load demo data from schemas/bundled-schema/ for shops, events, gacha, etc.:

psql -U postgres -d erupe -f schemas/bundled-schema/EventQuests.sql
psql -U postgres -d erupe -f schemas/bundled-schema/OtherShops.sql
# ... any others you want

2. Configure

Copy config.example.json to config.json and edit it. At minimum, set:

• Host — your server IP (or 127.0.0.1 for local play)
• Database — PostgreSQL connection details
• ClientMode — must match your game client version (default: ZZ)

See Erupe Configuration for full reference.

3. Build and Run

go build -o erupe-ce
./erupe-ce

Docker Alternative

From the docker/ directory:

docker compose up db pgadmin    # Start PostgreSQL + pgAdmin (http://localhost:5050)
# Use pgAdmin to restore init.sql and apply patch schemas
docker compose up server        # Start Erupe

Wiki Pages

Setup & Operations

• Database Setup — schema management, table reference, bundled demo data, common admin SQL
• Server Operations — quest/scenario files, save system, REST API, Discord bot, Docker
• Erupe Configuration — full config.json reference (general, debug, gameplay, worlds, courses)
• Commands — in-game chat commands (general, admin, Raviente)
• Player Commands — player-friendly command reference with usage examples

Development

• Contributing — adding packet handlers, debugging, testing, CI

Reference

• Enumerations — distribution types, item types, course types, quest types and flags
• Client Versions — all MHF versions from Season 1.0 to Z3.1 with dates, platforms, and ClientMode IDs
• Scenarios — scenario quest database with IDs and dates (Forward through end-of-service)
• Hard Core Monsters Schedule Map — HC/GHC monster schedule data from mhfsch.bin