Skip to main content

General Module

Features​

  • Configure custom join/quit messages per permission group
  • Block crafting for unauthorized players
  • Restrict access to specific inventory types
  • Compact items into target items via cooldown

Configuration Reference​

KeyTypeDefaultDescription
enabledbooleantrueEnable or disable general module
chat.disable-item-displaybooleanfalseDisable item display in chat
chat.remove-vanilla-death-messagebooleanfalseSuppress vanilla death messages
chat.show-custom-death-messagebooleanfalseEnable custom death messages
session-messagesobject[][]Join/quit messages definitions (priority, identifier, permission, join-message, quit-message)
disable-craftingbooleanfalsePrevent crafting for players without firebox.crafting.bypass
blocked-inventoriesstring[][]List of inventory types to block (e.g., ANVIL, FURNACE)
compact-settings.compact-cooldownnumber5Cooldown (in seconds) for the /compact command
compact-settings.compact-itemsobject[][]Item mappings for compaction (source-item, target-item)

Session Messages​

You can configure custom join/quit messages for each permission group.

Format:

- priority: NUMBER
identifier: IDENTIFIER
permission: PERMISSION
join-message: MESSAGE
quit-message: MESSAGE
Priority

priority is used to sort ranks; higher number means higher priority.

Disable Crafting​

You can disable crafting for players without the firebox.crafting.bypass permission.

disable-crafting: true

Blocked Inventories​

You can restrict access to specific inventory types.

blocked-inventories:
- ANVIL
- FURNACE
- BLAST_FURNACE
- CRAFTING

Supported types:

Compact Items​

Configure compaction of items into target items via /compact command. The source-item amount is required, and the target will drop target-item amount.

compact-settings:
compact-cooldown: NUMBER
compact-items:
- source-item: ITEM
target-item: ITEM
Item configuration

Refer to Item Format for item definition syntax.

Example​

general.yml
enabled: true
chat:
disable-item-display: false
remove-vanilla-death-message: true
show-custom-death-message: true
session-messages:
- priority: 0
identifier: default
permission: ""
join-message: ""
quit-message: ""
- priority: 10
identifier: vip
permission: vip
join-message: "&8[&c+&8] &e%player_name%"
quit-message: "&8[&c-&8] &e%player_name%"
disable-crafting: false
blocked-inventories:
- ANVIL
- FURNACE
- BLAST_FURNACE
- CRAFTING
compact-settings:
compact-cooldown: 5
compact-items:
- source-item:
material: IRON_INGOT
amount: 9
damage: 0
custom-model-data: -1
unbreakable: false
lore: []
enchantments: []
flags: []
target-item:
material: IRON_BLOCK
amount: 1
damage: 0
custom-model-data: -1
unbreakable: false
lore: []
enchantments: []
flags: []