Skip to content

Token SMP — Overview

Version: 1.0.0
Minecraft Version: Paper 1.21+
Developer: CiscoCodes (GitHub)

Introduction

Token SMP is an advanced ability-token system for Minecraft Paper 1.21+ servers that transforms SMP gameplay with 28 unique mob-themed tokens, each granting distinct passive buffs and active combat abilities. Players collect Soul Fragments from mob drops, craft them into Tokens using special recipes, and equip up to 2 Tokens simultaneously to build their combat identity.

Unlike traditional ability plugins, Token SMP features a complete SMP lifecycle — from cinematic server launches with world border expansion, to grace periods, dramatic token awakenings, and a PvP death-stealing system that keeps every fight meaningful.

Features

Core Features

  • 28 Unique Mob-Themed Tokens with distinct passive and active abilities
  • Soul Fragment System — Kill mobs for rare Soul Fragment drops (configurable 0.5% chance)
  • Equip System — Players equip up to 2 tokens simultaneously
  • Token Transfer on Death — Killers steal tokens from their victims in PvP
  • Ritual Crafting Mode — Transform token crafting into dramatic server-wide events
  • Awakening System — Cinematic random token reveal for all players at SMP start
  • Custom Action Bar HUD — Live display of equipped tokens with cooldown timers
  • Recipe GUI — Paginated in-game recipe browser
  • Trust System — Trust allies to prevent friendly fire from AoE abilities
  • Admin Management Tools for full server control

SMP Management

  • SMP Start System — Full server launch sequence with cinematic countdown, world border expansion, and grace period
  • Grace Period System — PvP protection with BossBar/ActionBar countdown, per-player support for late joiners
  • World Border Expansion — Configurable border growth with speed-based duration calculation

Token Transfer System

  • PvP Death Stealing — Killers automatically steal a token from victims
  • Selection Modes — Random, first, second, newest, rarest, or GUI choice
  • Totem Protection — Totem of Undying prevents token loss
  • Server Announcements — Configurable broadcast radius for transfer events

Ritual Crafting

  • 3D Floating Display — Token model materializes in the air with rotation and bobbing
  • BossBar Progress — Color-shifting progress bar visible to all players
  • Particle Effects — Spiral flames, enchantment glints, increasing intensity
  • Hologram Display — Token name, charge percentage, time remaining
  • Protection Zone — Configurable radius around ritual site
  • Persistence — Active rituals survive server restarts

Localization

  • Multi-Language Support — 8 built-in languages (English, Spanish, French, German, Polish, Dutch, Hindi, Urdu)
  • Auto-Detection — Automatically detects client language on join
  • Per-Player Language — Players can choose their own language

Social Systems

  • Trust System — Trust players to prevent your AoE abilities from targeting them
  • Unidirectional Trust — Trusting someone doesn't mean they trust you back
  • Healing Inclusion — Support abilities (e.g., Axolotl) heal trusted allies

Token Tiers

Each token belongs to one of four power tiers:

Tier Rarity Color Description
S-Tier Gold (Legendary) Strongest tokens — Dragon, Warden, Wither
A-Tier Purple (Epic) High-impact combat tokens
B-Tier Aqua (Rare) / Purple (Epic) Balanced offensive and utility tokens
C-Tier Aqua (Rare) / Purple (Epic) Situational and support tokens
D-Tier White (Common) / Aqua (Rare) Accessible entry-level tokens

How It Works

Gameplay Loop

  1. Kill mobs to collect Soul Fragments (0.5% drop chance from any mob)
  2. Craft tokens in a crafting table (Soul Fragment in center slot + themed materials)
  3. Right-click the token item (Nether Star) to equip it
  4. Use abilities via /token <ability> commands (e.g., /token warden, /token enderman save home)
  5. PvP kills steal tokens from victims — every fight has stakes
  6. Trust allies to prevent your AoE from hurting them

SMP Start Sequence

  1. Admin runs /token start
  2. Cinematic countdown with titles and sounds
  3. World border begins expanding from initial size
  4. Grace period activates (PvP disabled)
  5. Grace period ends — Awakening begins, randomly assigning tokens to all players
  6. Full PvP enabled — the SMP is live

Dependencies

  • FaithBreak — Optional dependency, auto-downloaded from Modrinth on first startup
  • Resource Pack — Included in Token Resource Pack/ for custom token models and action bar HUD

Support & Credits