Gost v2.3.2 — a multiplayer asymmetric PvP mini-game plugin for Bukkit/Spigot Minecraft servers.
Inspired by 《Dead Realm》 — a tribute to that beloved but now-gone game, and an attempt to recreate its tension of chase and mind games inside Minecraft.
| Faction | Description |
|---|---|
| 👤 Human | Starting identity; becomes a Ghost once infected |
| 👻 Ghost | Infects Humans to make them join the Ghost faction; the Mother is the Ghost leader |
| Role | Description |
|---|---|
| 🛡️ Divine Guardian | Blocks 3 Ghost attacks; each attack randomly teleports the attacker |
| 🎯 Demon Hunter | Converted from a Human during the Demon Hunter phase; wields the Reaper to fight back |
| 👑 Mother | Ghost faction leader; can attack Demon Hunters and infect normal Humans |
| ✨ Redeemer | Permanent role, up to 2 per match; holds the Holy Redemption item to convert Ghosts back to Humans |
Activation: Remaining Humans ≤ trigger count (default 2)
Defense count: Blocks 2 attacks
Teleport effect: The holder is randomly teleported when attacked
Demon Hunter phase: All Divine Guardians refresh their defense count and convert into Demon Hunters
Activation: Remaining Humans ≤ trigger count (default 2)
Defense count: Blocks 3 attacks
Teleport effect: The attacker is randomly teleported nearby and slowed
Demon Hunter phase: All Divine Guardians refresh their defense count and convert into Demon Hunters
Version notes:
🔹 Before v2.2.2: 2 defenses, teleports the holder
🔹 Since v2.2.2: 3 defenses, teleports and slows the attacker
Activation: Remaining Humans ≤ trigger count (default 2)
Defense count: Blocks 3 attacks
Teleport effect: On each hit, the attacker is randomly teleported nearby and slowed
Demon Hunter phase: All Divine Guardians refresh their defense count and convert into Demon Hunters
💡 The Divine Guardian mechanic remained stable in this version, identical to v2.2.2+.
Activation: Remaining Humans ≤ trigger count (default 2)
Defense count: Blocks 3 attacks
Teleport effect: The attacker is randomly teleported nearby and slowed
Demon Hunter phase: All Divine Guardians refresh their defense count and convert into Demon Hunters
💡 The classic Divine Guardian mechanic is unchanged. The new Redeemer system has its own independent Divine Guardian (see the Redeemer section below).
Activation: When Humans drop to 1, the last Human becomes the Redeemer
Holy Redemption item: The Redeemer receives an exclusive item that converts Ghosts back to Humans
Random teleport: After use, the Redeemer is randomly teleported to a safe spot
Use limit: The item has 2 uses (configurable); afterwards the player reverts to a normal Human
Visuals: The Redeemer is highlighted the whole time and gains a speed effect
Activation: The Human who receives the [Holy Redemption] item becomes the Redeemer; they can no longer receive Divine Guardian and the role cannot be cancelled
Holy Redemption item: The Redeemer receives an exclusive item that converts Ghosts back to Humans
Random teleport: After use, the Redeemer is randomly teleported to a safe spot
Use limit: The item has 1 use; the Redeemer identity is kept afterwards
Visuals: The Redeemer is surrounded by cloud particles the whole time
Version evolution:
🔹 Before v2.2.2: The last player becomes the Redeemer, 2 uses, reverts to a normal Human when used up
🔹 Since v2.2.2: A randomly granted item creates the Redeemer, 1 use, Redeemer identity is retained
Activation: The Human who receives the [Holy Redemption] item becomes the Redeemer; they can no longer receive Divine Guardian and the role cannot be cancelled
Holy Redemption item: The Redeemer receives an exclusive item that converts Ghosts back to Humans
Random teleport: After use, the Redeemer is randomly teleported to a safe spot
Use limit: The item has 1 use; the Redeemer identity is kept afterwards
Visuals: The Redeemer is surrounded by cloud particles the whole time
💡 The Redeemer mechanic in this version is identical to v2.2.2+.
Permanent mechanic: The Redeemer is present in every match, up to 2 per match
Activation: Randomly bound to a Human player via the "Holy Redemption" item
Independent Divine Guardian: The Redeemer directly gains an independent Divine Guardian (2 defenses) without affecting the original Divine Guardian system
Holy Redemption item: The Redeemer receives an exclusive item that converts Ghosts back to Humans
Use limit: The item has 2 uses; the Redeemer identity is kept afterwards
Random teleport: After use, the Redeemer is randomly teleported to a safe spot
Visuals: The Redeemer is surrounded by cloud particles the whole time
💡 Major v2.3.1 update: mode switching removed, Redeemer is now permanent; independent guardian 2 defenses + 2 Holy Redemption uses; up to 2 per match.
Items are distributed on a timer during the match — the interval is configurable (default: every 60 seconds) — and items also spawn randomly in the area. When items are distributed, all player positions are revealed for 5 seconds.
Inventory management (v2.3.1): Up to 9 items during a match. Items cannot be placed in the inventory, do not stack, and duplicates are not allowed (except universal items). The Reaper / Holy Redemption are forced into the first slot.
🗡️ Rush Spear (v2.3.2 update):
• Right-click to dash forward 5 blocks; the item is consumed immediately.
• All-version compatible: displays as a Trident on <1.21.4 and as a Spear on ≥1.21.4 — identical functionality.
• Sound: spear dash sound (built into the game).
New in v2.3.2 — In-match hunger drain, configurable and toggleable. In-match hunger is independent of the world outside; after settlement the pre-match food level is restored.
Configuration options are located under the food node in config.yml, supporting toggles, restore speed and other parameters.
ENTITY_ITEM_PICKUP (different pitch per item)BLOCK_NOTE_BLOCK_PLINGENTITY_VEX_AMBIENT (eerie whisper)ENTITY_PLAYER_LEVELUP (level-up sound)BLOCK_NOTE_BLOCK_HAT (once per second)ENTITY_ENDER_DRAGON_GROWL (server-wide)UI_TOAST_CHALLENGE_COMPLETE, Ghosts get ENTITY_WITHER_DEATHUI_TOAST_CHALLENGE_COMPLETE, Humans get ENTITY_WITHER_DEATHENTITY_WITHER_DEATH at the kill locationENTITY_ENDER_DRAGON_GROWLWhen 3 minutes remain in the game, the system randomly converts some non-Mother Ghost players back to the Human faction (disabled by default; can be enabled in the config).
Players must pay an entry fee to join (default 100 coins); the fee flows into the Human prize pool. Servers can also set an extra bonus (default 5000 coins) to increase the total pool.
| Winning Side | Distribution Rule |
|---|---|
| 👤 Human Victory | Humans receive 70% of the pool, Ghosts receive 30% |
| 👻 Ghost Victory | Ghosts receive 100% of the pool |
| Faction | Distribution Method |
|---|---|
| 👤 Human | 100% distributed by survival time ratio |
| 👻 Ghost | 70% by Ghost survival time + 30% by infection count ratio |
Each Ghost killed by a Demon Hunter grants 30% of the Human prize pool; the Mother killing a Demon Hunter grants a 50% extra reward (higher than a normal infection reward).
A prize leaderboard is shown after the game, with 🥇🥈🥉 medals for the top three.
Uses the native Minecraft DARKNESS effect (1.19+) or BLINDNESS (older versions).
An attribute modifier adds 30% movement speed to offset the darkness effect's impact on sprinting.
Player sprint state is checked every 10 ticks to automatically restore blocked sprinting.
Admins and creative-mode players are also affected by the darkness effect.
Ghost players display continuous orbiting particle effects.
Mother Ghost: red particles; Normal Ghost: green particles.
Supports 21 particle types with customizable RGB colors.
Whether to display during the preparation phase is configurable.
Greatly expanded default message library with 90+ default Chinese messages.
Smart message fallback — no more raw error codes.
Error isolation protection that does not affect the core game flow.
Plugin startup protection — the plugin still runs even if LanguageManager fails to initialize.
Humans hear a looping Warden heartbeat sound during the game.
Admins can toggle it via /gostadmin heartbeat.
Up to 9 items during a match.
Items cannot be placed in the inventory (forced back to the hotbar).
Items do not stack, duplicates are not allowed, and two Adrenalines are not allowed (except universal items).
Reaper / Holy Redemption are forced into the first slot.
A flame particle frame is automatically displayed after setting a selection, lasting 30 seconds.
Helps admins visually confirm the game area boundary.
Core events such as revival waiting, respawn, harvest, redemption and Mother root now have bilingual (Chinese/English) subtitles.
Automatically switched based on the server language setting.
Supports all versions from 1.20.x to 1.21.x.
Particles / sounds / item names are automatically version-compatible.
The Rush Spear (v2.3.2) is now fully version-compatible: Trident on <1.21.4, Spear on ≥1.21.4.
As of v2.3.1, the /divineguardian and /ghostparticle commands have been merged into /gostadmin.
The legacy commands still work, but the new unified format is recommended. All available commands and permissions are listed below.
| Command | Description | Permission |
|---|---|---|
/gost join | Join the game queue | gost.player |
/gost leave | Leave the game queue | gost.player |
/gost info | View game information | gost.player |
/gost help | Show help | gost.player |
/gost start | Admin force-start the game (skips the player count requirement) | gost.admin |
/gost stop | Force-end the game | gost.admin |
/gost reload | Reload the configuration file | gost.admin |
/gostadmin tool | Get the selection tool (magma cream) | gost.admin |
/gostadmin pos1/pos2 | Set selection points | gost.admin |
/gostadmin save/list/load/delete/info | Area management | gost.admin |
/gostadmin dark <on/off/status> | Darkness effect management | gost.admin |
/gostadmin heartbeat <on/off/status> | Heartbeat sound management | gost.admin |
/gostadmin testmode | Single-player test mode | gost.admin |
/gostadmin giveitem <item> | Directly receive a specified item (fuzzy matching supported) | gost.admin |
/gostadmin economy <set|status> | Economy management | gost.admin |
/divineguardian Legacy | Divine Guardian management (merged into /gostadmin divine) | gost.admin |
/ghostparticle Legacy | Ghost particle management (merged into /gostadmin particle) | gost.admin |
/gostadmin divine <status|clear> — Divine Guardian management (replaces /divineguardian)/gostadmin particle <status|enable|disable> — Ghost particle management (replaces /ghostparticle)💡 The legacy /divineguardian and /ghostparticle commands still work, but migrating to the new commands is recommended for consistency.
After setting a selection, a flame particle frame is displayed along the boundary for 30 seconds.
| Permission Node | Description | Default |
|---|---|---|
gost.use | Basic command permission | All players |
gost.player | Player game permission | All players |
gost.admin | Administrator permission | OP |
gost.admin.divineguardian Legacy | Divine Guardian management permission (merged into gost.admin) | OP |
gost.admin.ghostparticle Legacy | Ghost particle management permission (merged into gost.admin) | OP |
Permission simplification notes (v2.3.1):
The legacy gost.admin.divineguardian and gost.admin.ghostparticle permissions have been merged into gost.admin.
The legacy permission nodes are still valid, but the new version uses gost.admin uniformly for all administrator features.
GOLDEN_SPEAR): left-click to dash, consumed on use (1.21.4+ only)LINGERING_POTION): right-click for 4.5s levitation/gost start — force start (skips the player count requirement)/gostadmin testmode — single-player test mode/gostadmin giveitem <item> — directly receive an item (fuzzy matching supported)🔊 New sound system:
Phase sounds:
• Last 3 seconds of the preparation countdown: BLOCK_NOTE_BLOCK_HAT (once per second)
• Game officially begins: ENTITY_ENDER_DRAGON_GROWL (server-wide)
• Human victory: Humans get UI_TOAST_CHALLENGE_COMPLETE, Ghosts get ENTITY_WITHER_DEATH
• Ghost victory: Ghosts get UI_TOAST_CHALLENGE_COMPLETE, Humans get ENTITY_WITHER_DEATH
Item distribution sounds:
• ENTITY_ITEM_PICKUP played for each player receiving an item (different pitch per item)
• Global cue once distribution finishes: BLOCK_NOTE_BLOCK_PLING
Item use sounds:
• Adrenaline: ENTITY_PLAYER_SPLASH
• Frenzy Potion: ENTITY_WITHER_SHOOT
• Frost Ball: ENTITY_SNOWBALL_THROW
• Soul Control: user ENTITY_ILLUSIONER_CAST_SPELL, controlled ghost ENTITY_ELDER_GUARDIAN_CURSE
• Stinky Steak: ENTITY_GENERIC_EAT + ENTITY_PLAYER_BURP
• Teleport Pearl: ENTITY_ENDER_PEARL_THROW
• Soul Detector: user ENTITY_ILLUSIONER_PREPARE_MIRROR, server-wide ENTITY_ENDER_DRAGON_FLAP
• Second Chance: user ITEM_TOTEM_USE, attacking ghost ENTITY_ELDER_GUARDIAN_CURSE, other players ENTITY_PLAYER_LEVELUP
🎬 New centered subtitle prompts for items:
• Adrenaline user: ⚡ Adrenaline! → Movement speed greatly increased!
• Frenzy Potion user: 💢 Frenzy Potion! → Attack and speed increased!
• Frost Ball victim: ❄ Frozen! → Movement speed reduced!
• Soul Control victim: ✧ Soul Controlled! → Cannot move!
• Stinky Steak user: 🥩 So stinky! → Speed increased, but your position is exposed!
• Soul Detector target: ⚠ Your position is exposed! → Every player can see you!
• Holy Redemption both sides: Redeemer ✝ Holy Redemption successful! / Redeemed ✝ You have been redeemed!
🌐 New English language support: set language.default: en_US in config.yml to switch to English.
⚙️ Automatic config migration: when a config version mismatch is detected, it migrates automatically and backs up the old config as config_old_v{version}.yml.
🔧 Fixed 1.20.x API compatibility.
Config version upgraded to 26.