- Dependencies
- Gear Core (Optional)
- Works With
The backbone of every gamemode, managing core functionality and shared mechanics.
Gamemodes
- Gamemode FFA - Everyone is your target. Get the most kills to win.
- Gamemode Gun Game - Progress through weapons with each kill. The first to complete wins.
- Gamemode Battle Royale - Fight to be the last player standing in an ever-shrinking safe zone.
- Gamemode Aim Train - Practice shooting and recoil on bots.
- Gamemode Scrim - Competitive team-based mode where two sides fight in short, round-based matches.
- Gamemodeless - A flexible, generic arena system with no predefined game rules.
- Gamemode Honey Drop - Race across breaking hexagon tiles as layers collapse beneath you. Outlast all opponents to win.
- Gamemode Raid Simulator - Work in progress.
Recommended Maps
Aimtrain by Reboot - Perfect map for running all the gamemode plugins. Has dedicated islands for each gamemode, central lobby, and everything spaced out nicely. Highly recommended!Permissions
gamemodecore.admin- Grants access to all commands required for setting up and managing the lobby and arenas.
Commands
/join- Teleports the player into the lobby. (Players can also enter the lobby by physically walking into it.)/leave- Removes the player from the arena, returning them to the lobby.gm.lobby create <position> <radius>- Creates a lobby at the specified position and radius.gm.lobby remove- Deletes the lobby.gm.lobby spawn add <position> <radius>- Adds a new spawn point to the lobby at the specified position and radius.gm.lobby spawn remove <spawnPointId>- Deletes the specified spawn point from the lobby.gm.lobby rule add <rule1> [<rule2> ...]- Adds one or more rules to the lobby. (See Rules for details on available rules.)gm.lobby rule remove <rule1> [<rule2> ...]- Removes one or more specified rules from the lobby.
here to use your current location.Quick Start
- Start by creating the lobby using
gm.lobby create <position> <radius>.
Example:gm.lobby create here 30creates a lobby at your current location with a radius of 30.
- Use
gm.lobby spawn add <position> <radius>to place spawn points where players will spawn. You can either create multiple spawn points or a single one with a large radius.
Example:gm.lobby spawn add here 5adds a spawn point at your location with a radius of 5.
- This step is optional, but if you'd like to enforce restrictions in the lobby—such as stopping players from harming each other or from dropping items on the ground—use
gm.lobby rule add <rule1>. (For a full list of rules, see Rules.)
Example:gm.lobby rule add NoPlayerDamage NoKillSelf NoSleepersprevents players from damaging each other, committing suicide, or sleeping within the lobby.
Configuration
JSON:
{
"Version": "1.4.0",
"Lobby": {
"Enable Lobby Only Mode": true,
"Respawn Gear Set": "Lobby",
"Join Chat Command": "join",
"Zone Opacity": 1,
"Locked Inventory Containers": [
"all"
]
},
"Arena": {
"Leave Chat Command": "leave",
"Send Join Leave Messages": true,
"Zone Opacity": 1
}
}
Lobby- Settings related to the lobby.Enable Lobby Only Mode- Forces players to spawn in the lobby whenever they connect or respawn, making the entire server lobby-focused. When disabled, players can freely explore normal gameplay areas outside the lobby.Respawn Gear Set- Specifies the gear set players are equipped with upon respawn in the lobby.Join Chat Command- Defines the chat command players can use to join the lobby.Locked Inventory Containers- Determines which parts of the player's inventory will be locked when they are in the lobby. You can choose one or more of the following values:main,belt,wear, orallI. If you leave it empty, none of the inventory sections will be locked.
Gamemode- Settings related to the arenas.Leave Chat Command- Defines the command players can use to leave the arena they're in.Send Join Leave Messages- Broadcasts a message to players when someone joins or leaves an arena.
Rules
Rules allow you to control player behavior and enforce restrictions within lobby and arena zones, such as stopping players from dropping items, preventing self-harm, or removing corpses upon death.NoLootSpawn- Prevents the spawning of loot containers within the zone. Any loot container that appears inside is removed.NoNPCSpawn- Prevents npcs from spawning within the zone. Npcs that try to spawn there are immediately killed.NoSignEditing- Disables the ability for players to edit wooden signs (and other sign-type entities) inside the zone.NoCrafting- Restricts players from crafting items while inside the zone. Craft attempts are blocked.NoCorpseSpawn- Disables player corpse creation on death. When a player dies in the zone, their corpse is removed.NoSleeping- Removes sleeper bodies when players disconnect inside the zone, so they don't stay as sleepers.NoItemDropping- Prevents players from dropping items on the ground. Dropped world items inside the zone are automatically deleted.NoBuilding- Prevents players from building structures within the zone. Build attempts are blocked.NoPvPDamage- Prevents any player-vs-player damage within the zone. Damage from other players is cleared, but environmental damage still applies unlessNoEnvironmentDamageis also set.NoEnvironmentDamage- Blocks non-PvP damage inside the zone, such as fall damage, radiation, explosions, traps, or other world/environment sources. Combine withNoPvPDamagefor full godmode-style protection.NoItemContainerSpawn- Blocks the spawning of dropped loot bags and item containers within the zone (e.g., death loot bags).NoKillSelf- Disables the player's ability to use thekillcommand to end their own character while inside the zone.NoWounding- Stops players from entering a wounded state when their health reaches zero; they die immediately instead of going down.NoArmoryBoxAccess- Prevents players from opening armory boxes while inside the zone. (Requires the Armory plugin.)NoItemWear- Prevents item durability loss. Items do not lose condition while used inside the zone.NoBleeding- Fully disables bleeding. Bleeding is constantly cleared and clamped to 0 so players do not lose health over time from bleed.NoHunger- Keeps players' hunger at maximum. Calories are constantly refilled so they don't take starvation damage.NoThirst- Keeps players' hydration at maximum. Thirst is constantly refilled so they don't take dehydration damage.NoHeldGunDrop- Prevents players from dropping the gun they are currently holding. Attempts to drop the active weapon are blocked so it stays in their inventory/hand.
Arena Teleporters
This information template holds arena details shown on the teleporter, and the placeholders below can be added to display real-time info, keeping players informed of the arena's current state.{Title}- Displays the title of the arena.{Gamemode}- Displays the game mode type, like 'Free For All' or 'Gun Game.'{Status}- Displays the arena's current phase, such as 'Started,' 'Waiting For Players,' 'Warmup,' or 'Finished.'{TimeLeft}- Displays the remaining time in the current round.{PlayerCount}- Shows the current number of players in the arena.{PlayerCapacity}- Displays the maximum player limit for the arena. If no limit is set, it shows 'Unlimited.'{PlayerList}- Lists the names of all players currently in the arena.
JSON:
"Information Template": "{Title}\nGamemode: {Gamemode}\nStatus: {Status}\nTime Left: {TimeLeft}\nPlayers: {PlayerCount} / {PlayerCapacity}\n\nParticipants:\n{PlayerList}",
Chat Isolation
Chat is isolated by area, so players can communicate only with others in the same zone. Players within an arena see only messages from others in that arena, while those in the lobby see only messages from other lobby members. Players outside of arenas and the lobby do not see messages from within these areas, keeping conversations focused and relevant to each zone.Stored Data
JSON:
{
"Lobby": {
"Radius": 30.0,
"Position": {
"x": -381.155762,
"y": 0.976623535,
"z": -388.7592
},
"Rules": ["NoBuild", "NoPlayerDamage", "NoSleepers"],
"Spawn Points": [
{
"Id": "001",
"Position": {
"x": -380.9209,
"y": 0.976623535,
"z": -392.3752
},
"Radius": 10.0
}
]
}
}
Localization
JSON:
{
Error.NoPermission: "You do not have permission to use this command."
Timer.WaitingForPlayers: "Waiting for players"
Timer.WarmingUp: "Warming up"
Timer.CompleteObjective: "Complete objective"
Timer.RoundEndsIn: "Round ends in"
Timer.NextRoundStartsIn: "Next round starts in"
Kill.YouKilled: "You killed <color=#55AAFF>{0}</color> with a <color=#CACF52>{1}</color> from <color=#75A838>{2}</color>."
Kill.KilledYou: "<color=#55AAFF>{0}</color> killed you with a <color=#CACF52>{1}</color> from <color=#75A838>{2}</color>."
Kill.KilledPlayer: "<color=#55AAFF>{0}</color> killed <color=#55AAFF>{1}</color> with a <color=#CACF52>{2}</color> from <color=#75A838>{3}</color>."
Lobby.CannotLeave: "You cannot leave the lobby."
}