Rules Configuration

File: rules/rules.json

Defines the server rules, organized in categories.

Complete Example

{
  "settings": {
    "showRuleNumbers": true,
    "itemsPerPage": 5
  },
  "categories": [
    {
      "id": "general",
      "name": "General Rules",
      "description": "Basic behavior rules",
      "icon": "Deco_Book",
      "rules": [
        {
          "title": "Be Respectful",
          "shortText": "Treat all players with respect.",
          "fullText": "Treat all players with respect. Insults, bullying, discrimination or harassment of any kind are strictly forbidden. We are a community where everyone should feel welcome.",
          "severity": "high",
          "consequence": "Warning -> Mute -> Ban"
        },
        {
          "title": "No Spam",
          "shortText": "Don't spam in chat or with commands.",
          "fullText": "Repeatedly sending the same or similar messages, excessive use of caps lock, or flooding the chat is forbidden.",
          "severity": "medium",
          "consequence": "Warning -> Mute"
        },
        {
          "title": "Language in Global Chat",
          "shortText": "Please use English or German in global chat.",
          "fullText": "In global chat, we ask you to use English or German so all players can understand the conversations. For other languages, please use private messages or group chats.",
          "severity": "low",
          "consequence": "Reminder"
        }
      ]
    },
    {
      "id": "gameplay",
      "name": "Gameplay Rules",
      "description": "Rules for fair play",
      "icon": "Weapon_Sword_Iron",
      "rules": [
        {
          "title": "No Cheating",
          "shortText": "Hacks and exploits are forbidden.",
          "fullText": "The use of hacks, cheats, exploits, modified clients or other unfair advantages is strictly forbidden. This includes X-Ray, fly hacks, speed hacks, aimbots and similar software.",
          "severity": "critical",
          "consequence": "Permanent Ban"
        },
        {
          "title": "No Griefing",
          "shortText": "Don't destroy other players' builds.",
          "fullText": "Intentionally destroying, damaging or defacing other players' builds without their permission is forbidden. This also applies to stealing items.",
          "severity": "high",
          "consequence": "Rollback + Ban"
        }
      ]
    }
  ]
}

Settings

{
  "settings": {
    "showRuleNumbers": true,
    "itemsPerPage": 5
  }
}

Setting	Type	Default	Description
`showRuleNumbers`	Boolean	`true`	Show rule numbers in the list
`itemsPerPage`	Integer	`5`	Rules per page in the list view

Category Structure

{
  "id": "category-id",
  "name": "Category Name",
  "description": "Category description",
  "icon": "Item_Id",
  "permission": null,
  "priority": 1,
  "rules": []
}

Field	Type	Description
`id`	String	Unique category ID
`name`	String	Display name
`description`	String	Category description
`icon`	String	Item ID for icon
`permission`	String	Permission to view this category (null = everyone)
`priority`	Integer	Sort order (lower = higher, default: `99`)
`rules`	Array	Rules in this category

Rule Structure

{
  "id": "rule-id",
  "title": "Rule Title",
  "shortText": "Short summary for the list.",
  "fullText": "Full description shown in detail view.",
  "severity": "high",
  "consequence": "Warning -> Ban",
  "icon": "Item_Id"
}

Field	Type	Description
`id`	String	Unique rule ID
`title`	String	Rule title (short and concise)
`shortText`	String	Short summary for list view
`fullText`	String	Full description for detail view
`description`	String	Alternative to `shortText`/`fullText` (used as fallback for both)
`severity`	String	Severity level
`consequence`	String	Consequence for violation
`icon`	String	Item ID for icon (optional)

Severity Levels

Value	Display	Color
`low` / `info`	Info	Blue (#3498db)
`medium` / `warning`	Warning	Orange (#f39c12)
`high` / `severe`	Severe	Red (#e74c3c)
`critical` / `ban`	Critical	Purple (#8e44ad)

Examples

Simple Rule (Single Description)

{
  "title": "Have Fun",
  "description": "This is a game - enjoy yourself and help others enjoy it too!",
  "severity": "info",
  "consequence": "None"
}

PvP Rules Category

{
  "id": "pvp",
  "name": "PvP Rules",
  "description": "Rules for player vs player combat",
  "icon": "Weapon_Sword_Iron",
  "rules": [
    {
      "title": "No Combat Logging",
      "shortText": "Don't disconnect during combat.",
      "fullText": "Disconnecting during PvP combat to avoid death is forbidden. You must wait at least 30 seconds after your last combat action before logging out.",
      "severity": "medium",
      "consequence": "Death + Warning"
    },
    {
      "title": "PvP Zones Only",
      "shortText": "PvP is only allowed in designated areas.",
      "fullText": "Player vs Player combat is only allowed in designated PvP zones. Attacking players in safe zones or spawn is forbidden.",
      "severity": "high",
      "consequence": "Warning -> Temp Ban"
    }
  ]
}

Building Rules Category

{
  "id": "building",
  "name": "Building Rules",
  "description": "Rules for construction and claims",
  "icon": "Tool_Pickaxe_Iron",
  "rules": [
    {
      "title": "Claim Your Builds",
      "shortText": "Protect your builds with claims.",
      "fullText": "We recommend claiming all your builds. Unclaimed builds are not protected and staff cannot help with grief recovery for unclaimed areas.",
      "severity": "info",
      "consequence": "N/A"
    },
    {
      "title": "No Inappropriate Builds",
      "shortText": "Keep builds family-friendly.",
      "fullText": "All builds must be appropriate for all ages. Offensive, explicit, or hate-related structures will be removed without warning.",
      "severity": "high",
      "consequence": "Removal + Ban"
    }
  ]
}

Formatting Rule Text

Color Codes

You can use Minecraft-style color codes in rule texts (shortText, fullText, consequence):

Code	Color	Code	Color
`&0`	Black	`&8`	Dark Gray
`&1`	Dark Blue	`&9`	Blue
`&2`	Dark Green	`&a`	Green
`&3`	Dark Cyan	`&b`	Cyan
`&4`	Dark Red	`&c`	Red
`&5`	Purple	`&d`	Pink
`&6`	Gold	`&e`	Yellow
`&7`	Gray	`&f`	White
`&r`	Reset

Example with colors:

{
  "title": "No Cheating",
  "shortText": "Hacks and exploits are &cforbidden&r.",
  "fullText": "The use of &chacks&r, &ccheats&r, and &cexploits&r is strictly forbidden. Violators will receive a &4permanent ban&r.",
  "severity": "critical",
  "consequence": "&4Permanent Ban&r"
}

:::tip Text Wrapping Rule texts automatically wrap to fit the display area. Long descriptions will be fully visible without truncation. :::

Best Practices

Prioritize by importance - Critical rules first
Be specific about consequences - “Ban” instead of “Punishment”
Use fullText for details - Short list, detailed view
Group logically - Related rules in same category
Keep titles short - Easy to scan in lists
Use colors sparingly - Highlight key terms only