Skip to content

Token SMP — Compatibility & Troubleshooting

Server requirements, compatibility info, and common issue fixes.

Server Requirements

Requirement Value
Minecraft Version Paper 1.21+
Java Version Java 21 or higher
Server Software Paper (Spigot compatibility not guaranteed)
RAM Minimum 2GB allocated to server

Plugin Dependencies

  • FaithBreak — Soft dependency, auto-downloaded from Modrinth on first startup if missing
  • Resource Pack — Included in Token Resource Pack/ directory. Contains custom item models for all 28 tokens, Soul Fragment, and a custom font for the action bar HUD

Known Compatibility

Status Details
Compatible Most economy, permission, and utility plugins
Compatible Anti-cheat plugins (properly configured)
Caution Plugins that modify crafting mechanics or intercept PrepareItemCraftEvent
Conflicts Other ability/token plugins that override Nether Star items

Data Files

Files created automatically in plugins/Token/:

File Purpose
config.yml Master configuration (all systems)
player_tokens.yml Player UUID to equipped token list
trust_data.yml Player trust relationships
player_languages.yml Per-player language preferences
gracedplayers.yml Tracks players who have received grace periods
awakenedplayers.yml Tracks players who have been awakened
worldborder_state.yml SMP state (who started, when, active status)
lang/*.yml 8 localized message files

Troubleshooting

Tokens Not Crafting

  1. Ensure the player has a Soul Fragment in the center slot (slot 5)
  2. Check if the token recipe is enabled in config.yml under token-recipes.<name>.enabled
  3. Verify the player has materials in the correct positions
  4. Check server console for recipe registration errors on startup

Abilities Not Working

  1. Confirm the token is equipped (check with /token tokens)
  2. Check cooldown status — abilities have cooldown periods shown in the action bar HUD
  3. For targeted abilities, make sure you're not targeting a trusted player
  4. Ensure the ability command matches the token (e.g., /token warden for the Warden token)

Token Not Equipping

  1. Check if the player already has max-traits-per-player tokens equipped (default: 2)
  2. If allow-duplicate-traits is false, the player can't equip two of the same token
  3. Verify the player has token.equip permission
  4. Ensure the item is a valid Token item (Nether Star with correct PersistentDataContainer tag)

SMP / Grace Period Issues

  1. Check SMP status: /token status
  2. View grace period status: /token graceperiod status
  3. Reload configurations: /token reload
  4. Reset SMP state: /token reset confirm

Awakening Issues

  1. Awakening triggers automatically after the grace period ends
  2. Late joiners who missed the awakening get a personal reveal on join
  3. Check awakenedplayers.yml if a player claims they weren't awakened
  4. Reset with /token reset confirm to re-enable awakening for all

Token Transfer Issues

  1. Verify token-transfer.enabled is true in config
  2. If using gui-choice mode, the killer has gui-choice-timeout seconds to pick
  3. Totem of Undying prevents token transfer (intentional)
  4. If the killer's slots are full and drop-as-item-when-full is true, the token drops on the ground

Ritual Mode Issues

  1. Check ritual mode is enabled: /token craftmode ritual
  2. Verify no concurrent ritual limit reached: /token ritual status
  3. Ensure the crafting table placement has open space above for the display
  4. Check for area protection conflicts with other plugins

Action Bar HUD Not Showing

  1. Ensure the resource pack is applied to the client
  2. The HUD uses custom font characters from the resource pack
  3. Check if another plugin is overriding the action bar

Language Issues

  1. Language auto-detects on join based on client locale
  2. Manually set language: /token language <code> (e.g., en_US, es_ES)
  3. Supported codes: en_US, es_ES, fr_FR, de_DE, nl_NL, pl_PL, hi_IN, ur_PK

Performance

  1. Reduce visual-settings.particle-intensity for ritual effects
  2. Lower max-concurrent-rituals if running multiple rituals
  3. Monitor server TPS during rituals and large-scale ability usage
  4. The action bar HUD updates every 20 ticks (1 second) — this is lightweight

Error Messages

Message Meaning
"You already have the maximum number of tokens!" Player has reached max-traits-per-player limit
"Token not found" Invalid token name in command
"You don't have this token equipped" Trying to use an ability for an unequipped token
"Ability on cooldown" Ability is still cooling down
"Ritual limit reached" Too many concurrent rituals active