Token SMP — Configuration
All plugin configuration is managed through a single unified config.yml file in plugins/Token/.
Grace Period System
Controls the PvP protection grace period when starting the SMP.
grace-period:
duration: 900 # Duration in seconds (default: 900 = 15 minutes)
display-type: BOSSBAR # Display type: BOSSBAR or ACTIONBAR
bossbar-color: GREEN # BossBar color: BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
per-player-enabled: true # Enable per-player grace periods for late joiners
Awakening System
Controls the token reveal system that runs after the grace period ends.
starting-traits:
enabled: true # Enable/disable awakening system
count: 1 # Number of tokens assigned per player on awakening
random: true # Random selection (true) or fixed (false)
reveal-animation:
enabled: true # Enable cinematic reveal animation
suspense-duration: 40 # Ticks of suspense animation before reveal
broadcast-to-server: true # Announce each player's awakening to the server
max-traits-per-player: 2 # Maximum tokens a player can equip simultaneously
allow-duplicate-traits: false # Allow equipping the same token twice
Persistence (Auto-Managed)
persistence:
awakening-complete: false # Set to true after awakening completes (auto-managed)
smp-started: false # Set to true after SMP starts (auto-managed)
Token Transfer System
Controls what happens when a player with tokens dies to another player in PvP.
token-transfer:
enabled: true # Enable token stealing on PvP death
drop-as-item-when-full: true # Drop as item if killer's slots are full
selection-mode: random # How to pick which token to steal:
# random, first, second, newest, rarest, gui-choice
gui-choice-timeout: 10 # Seconds before GUI auto-selects (gui-choice mode)
announce-to-server: true # Broadcast transfer events
announce-radius: -1 # -1 for global, or radius in blocks
World Border Expansion
Settings for the world border expansion system.
world-border:
initial-size: 50 # Starting border size in blocks
final-size: -1 # Final size (-1 = Minecraft default 59,999,968)
expansion-speed: 5.6 # Blocks per second per side
expansion-countdown: 10 # Countdown before expansion starts (seconds)
Countdown Effects
Visual and audio effects during the SMP start countdown.
countdown-effects:
countdown-title: "Token SMP"
countdown-subtitle: "Starting in {seconds}"
countdown-title-color: "DARK_GREEN"
countdown-subtitle-color: "GREEN"
countdown-sound: "BLOCK_NOTE_BLOCK_PLING"
sound-volume: 1.0
sound-pitch: 1.0
Expansion Announcement
Announcement settings when the world border starts expanding.
expansion-announcement:
expansion-title: "World Expanding!"
expansion-subtitle: "The world border is growing..."
expansion-title-color: "GREEN"
expansion-subtitle-color: "AQUA"
chat-announcement: true
chat-message: "The world border is expanding! Prepare for adventure!"
Startup Messages
Messages displayed after the world border expansion starts.
startup-messages:
enabled: true
sound-sequence:
thunder:
enabled: true
sound: "ENTITY_LIGHTNING_BOLT_THUNDER"
volume: 2.0
pitch: 0.9
delay: 0
dragon:
enabled: true
sound: "ENTITY_ENDER_DRAGON_GROWL"
volume: 2.0
pitch: 0.8
delay: 1
separator: "----------------------------------------"
message1:
enabled: true
text: "Token SMP has started!"
message2:
enabled: true
text: "All players get {grace_period} min grace period (PvP disabled)"
message3:
enabled: true
text: "Welcome to the ultimate survival experience!"
message4:
enabled: true
text: "Good luck, everyone! ~ CiscoCodes"
Ritual Crafting System
Ritual Mode
ritual-mode:
enabled: false # Toggle ritual crafting mode
max-concurrent-rituals: 1 # Max simultaneous rituals server-wide
queue-settings:
max-queue-size: 50 # Maximum rituals in queue
max-wait-time: 10 # Max wait time in queue (minutes)
process-interval: 1 # Queue check interval (seconds)
Ritual Durations
Per-token ritual duration in seconds.
ritual-durations:
RAVAGER: 120
GUARDIAN: 120
PHANTOM: 120
BLAZE: 120
POLARBEAR: 120
ENDERMAN: 120
SKELETON: 120
SPIDER: 120
WOLF: 120
CREEPER: 120
AXOLOTL: 120
DRAGON: 180
WARDEN: 180
ZOMBIE: 120
WITHER_SKELETON: 120
SQUID: 120
GHAST: 120
DOLPHIN: 120
FROG: 120
PIGLIN_BRUTE: 120
IRON_GOLEM: 120
BAT: 120
BEE: 120
HOGLIN: 120
WITHER: 180
MAGMA_CUBE: 120
VILLAGER: 120
PILLAGER: 120
Ritual Announcements
announcement-settings:
title-duration: 5
subtitle-fade: 2
boss-bar-color: "PURPLE"
ritual-start-title: "Token RITUAL"
ritual-start-subtitle: "Defend the token as it charges!"
ritual-complete-title: "Token Ritual Complete!"
ritual-complete-subtitle: "{token_name} has been forged!"
Ritual Protection Zone
protection-settings:
radius: 15 # Protection radius around ritual site
block-breaking: false # Allow block breaking in ritual zone
pvp-enabled: true # Allow PvP in ritual zone
mob-spawn-multiplier: 1.5 # Mob spawn rate increase in ritual zone
Ritual Visuals
visual-settings:
particle-intensity: 1.0 # Particle effect intensity
hologram-update-interval: 20 # Ticks between hologram updates
model-rotation-speed: 0.5 # Floating token rotation speed
bobbing-amplitude: 0.5 # Bobbing motion amplitude
Ritual Display
display-method: "ItemDisplay" # Methods: ItemDisplay (1.19.4+), BlockDisplay, TextDisplay, ArmorStand
animation:
rotation-speed: 0.314159
bobbing:
amplitude: 0.5
frequency: 0.1
visual:
scale: 1.0
glow: true
brightness: 15
particle-settings:
enabled: true
hologram-settings:
enabled: true
persistence-settings:
save-on-shutdown: true
restore-on-startup: true
Soul Fragment Settings
soul-fragment:
drop-chance: 0.005 # Drop chance from any mob kill (0.5%)
name: "Soul Fragment" # Display name
lore: # Item lore lines
- "A fragment of pure essence"
- "Used to craft powerful Tokens"
- ""
- "Place in the center of a"
- "crafting table to forge Tokens"
Trust System
Token Recipes
All 28 token recipes use a 3x3 crafting grid (slots 1-9). Every recipe requires a Soul Fragment in the center slot (slot 5). Each token recipe can be individually enabled/disabled.
token-recipes:
dragon:
enabled: true
recipe:
1: END_CRYSTAL
2: DRAGON_HEAD
3: END_CRYSTAL
4: DRAGON_BREATH
5: SOUL_FRAGMENT # Always Soul Fragment in center
6: DRAGON_BREATH
7: NETHERITE_INGOT
8: NETHER_STAR
9: NETHERITE_INGOT
# ... (all 28 tokens configurable)
Ability Attributes
All ability attributes are configurable per token including cooldowns, damage values, durations, radii, and effect levels. Cooldowns are in seconds, durations in ticks (20 ticks = 1 second) unless otherwise noted.
ability-attributes:
warden:
sonic-boom:
cooldown: 25 # Seconds
damage: 30.0
range: 16.0
angle: 45.0
stun-duration: 60 # Ticks
dragon:
breath:
cooldown: 20
damage: 8.0
# ... (all 28 tokens configurable)
Runtime-Generated Files
The following files are created automatically at runtime:
| File | Purpose |
|---|---|
player_tokens.yml |
Stores player UUID to equipped token list mapping |
trust_data.yml |
Stores player trust relationships |
player_languages.yml |
Stores per-player language preferences |
gracedplayers.yml |
Tracks players who have already received grace periods |
awakenedplayers.yml |
Tracks players who have already been awakened |
worldborder_state.yml |
Persists SMP state (who started, when, active status) |
Language Files
8 built-in language files are located in plugins/Token/lang/:
| File | Language |
|---|---|
en_US.yml |
English (US) |
es_ES.yml |
Spanish |
fr_FR.yml |
French |
de_DE.yml |
German |
pl_PL.yml |
Polish |
nl_NL.yml |
Dutch |
hi_IN.yml |
Hindi |
ur_PK.yml |
Urdu |
Players' client language is auto-detected on join. Language preference can be changed with /token language <code>.