Modes

SporeCore includes a feature called Modes, which allows you to create custom staff modes. These modes are designed so staff members can watch players, moderate the server, or manage issues without being noticed.

You can create your own modes in the modes.yml file.

Make sure the modes feature is enabled in config.yml. Once everything is enabled, restart your server, and you’re ready to use modes in-game.

⚙️ Configuration

By default, SporeCore comes with two modes:

• Staff mode

• Admin mode

When you run /staffmode in-game, SporeCore will:

1. Check which modes you have permission for.

2. Compare the weight of those modes.

3. Enable the mode with the highest weight.

🔹 Why weight matters

This is useful if you have different staff roles. For example:

• Normal staff → Staff mode

• Admins → Admin mode

If an admin has permission for both modes, SporeCore will select the mode with the highest weight, ensuring admins automatically get more powerful tools.

To create a new mode, simply copy one of the default modes and modify it to your needs.

modes:
  staff:
    name: Staff
    id: staff
    weight: 1
    commands:
    - staffmode
    - sm
    permission: sporecore.mode.staff
    gamemode: SURVIVAL
    invulnerable: true
    pvp: false
    vanish: true
    blockBreak: false
    blockPlace: false
    itemPickup: false
    itemDrop: false
    silentChest: true
    inventory: false
    enableCommands:
    - util player sendmessage %player% &cWelcome in Staffmode!
    disableCommands:
    - util player sendmessage %player% &cByee
    blockedCommands:
    - invrestore
    chat: true
    flight: true
    tpBack: true
    clearInv: true
    items:
      0: punish_sword
      4: history
      8: speed
  admin:
    name: Admin
    id: admin
    weight: 2
    commands:
    - adminmode
    - am
    permission: sporecore.mode.admin
    gamemode: CREATIVE
    invulnerable: true
    pvp: true
    vanish: false
    blockBreak: true
    blockPlace: true
    itemPickup: true
    itemDrop: true
    silentChest: true
    inventory: true
    blockedCommands:
    - invrestore
    chat: true
    flight: true
    tpBack: true
    clearInv: true
    items:
      0: freeze
      3: punish_sword
      5: history
      8: speed

🔍 Explanation of Mode Options

🔹 General Settings

• name: Display name of the mode.

• id: Unique identifier for the mode.

• weight: Priority of the mode. Higher weight = higher priority.

• commands: Commands used to enable this mode.

• permission: Permission required to use the mode.

• gamemode: Gamemode applied when the mode is enabled.

---

🔹 Player Behavior

• invulnerable: Prevents the player from taking damage.

• pvp: Allows or disables PvP while in the mode.

• vanish: Makes the player invisible to others.

• flight: Enables flight.

• chat: Allows chatting while in the mode.

---

🔹 World Interaction

• blockBreak: Allows breaking blocks.

• blockPlace: Allows placing blocks.

• itemPickup: Allows picking up items.

• itemDrop: Allows dropping items.

• silentChest: Prevents chest animations and sounds when opening containers.

• inventory: Allows opening and modifying inventories.

---

🔹 Commands & Inventory

• enableCommands: Commands executed when the mode is enabled.

• disableCommands: Commands executed when the mode is disabled.

• blockedCommands: Commands players are not allowed to run while in this mode.

• clearInv: Clears the player’s inventory when entering the mode.

• tpBack: Teleports the player back to their original location when disabling the mode.

🔹 Mode Items

items:
  0: punish_sword
  4: history
  8: speed

• The number represents the inventory slot.

• The value is the mode item ID.

🧰 Items

SporeCore includes several built-in mode items that can be placed directly into a staff member’s inventory when a mode is enabled.

These items are hardcoded and designed specifically for moderation and staff tools. More items will be added in future updates.

To see a full list of available items in-game, run:

/mode itemlist

Each item has a specific purpose, such as punishment tools, player history, speed control, or freezing players.

This system gives you full control over staff moderation, allowing you to create lightweight staff modes or powerful admin modes depending on your server’s needs.