SpawnSystem [1.20 - 1.21] icon

SpawnSystem [1.20 - 1.21] -----

High-performance spawn system with async countdown, configurable permissions and messages.



OnlySyntax Icon.png SpawnSystem – 1.0.0

High-end spawn system built for modern Paper/Pufferfish 1.21+ networks.
Designed to handle 100+ concurrent players while keeping a rock-solid 20.0 TPS.
Everything is controlled via a clean config.json – permissions, messages, cooldown, sounds, behavior – fully customizable.

✨ Core Features
  • /spawn with live countdown
    Configurable countdown before teleport (e.g. 3 → 3, 2, 1 → teleport).
    One clean task per player, no spam, no dupe teleports, no race conditions.

  • Admin setup commands
    • /spawn setup set – set the global spawn
    • /spawn setup delete – remove the spawn
      All fully permission-controlled and the permission nodes are configurable in config.json.
  • 100% configurable permission nodes
    You choose the exact permission strings:
    Default: onlysyntax.spawn, onlysyntax.setup.set, onlysyntax.setup.delete –
    but you can rename them to anything you want.
    Each permission check can be enabled or disabled via booleans.

  • Fully customizable messages
    Every message is editable, including:
    no permission, usage, spawn set, spawn deleted, teleported, teleport already in progress, countdown (%seconds%) and more.
    Uses § color codes directly in config.json for full formatting control.

  • Optional level-up sound on teleport
    Play a level-up sound when the player is teleported to spawn:
    • levelUpEnabled – enable/disable
    • levelUpVolume and levelUpPitch – fine-tune the effect
  • Join / respawn behavior
    Highly flexible teleport logic for lobby / hub servers:
    • on-join – teleport on every join
    • on-respawn – respawn players at spawn
    • on-firstjoin – teleport only on first join
      All toggled via simple booleans in config.json.
  • Modern stack
    • Built for Java 17
    • Optimized for Pufferfish/Paper 1.21.x
⚙️ Performance & Reliability
  • Extremely lightweight logic – no heavy loops, no expensive calculations.
  • Countdown uses tiny per-player scheduler tasks, automatically cleaned up on quit and shutdown.
  • Configuration is stored in config.json and saved asynchronously via Jackson to avoid main-thread I/O lag.
  • Minimal memory footprint – no unnecessary caches, no long-lived background threads.
  • Engineered for large servers and networks with 100+ online players while keeping TPS stable and the experience smooth.

    Code (YAML):
    {
      "permissions"
    : {
        "useSpawn"
    : true,
        "spawnNode"
    : "onlysyntax.spawn",
        "useSetupSet"
    : true,
        "setupSetNode"
    : "onlysyntax.setup.set",
        "useSetupDelete"
    : true,
        "setupDeleteNode"
    : "onlysyntax.setup.delete"
      },
      "cooldown"
    : {
        "enabled"
    : true,
        "seconds"
    : 3
      },
      "teleport"
    : {
        "on-join"
    : false,
        "on-respawn"
    : false,
        "on-firstjoin"
    : false
      },
      "messages"
    : {
        "noPermission"
    : "§cYou do not have permission.",
        "spawnNotSet"
    : "§cSpawn has not been set yet.",
        "spawnSet"
    : "§aSpawn point set.",
        "spawnDeleted"
    : "§aSpawn point deleted.",
        "teleported"
    : "§aTeleported to spawn.",
        "playerOnly"
    : "§cOnly players can use this command.",
        "teleportInProgress"
    : "§cTeleport is already in progress.",
        "countdown"
    : "§aTeleporting in §e%seconds% §aseconds...",
        "usageSpawnSetup"
    : "§eUsage: /spawn setup <set|delete>",
        "usageSpawnOrSetup"
    : "§eUsage: /spawn or /spawn setup <set|delete>"
      },
      "sound"
    : {
        "levelUpEnabled"
    : true,
        "levelUpVolume"
    : 1.0,
        "levelUpPitch"
    : 1.0
      },
      "spawn"
    : {
        "world"
    : "world",
        "x"
    : 102.92487533727534,
        "y"
    : 68.0,
        "z"
    : 151.82983462494124,
        "yaw"
    : -175.3863,
        "pitch"
    : 12.646658
      }
    }

    Support & Community
    Discord: https://discord.com/invite/uwffG2vrRB
    Join for support, updates, suggestions, and beta builds!
Resource Information
Author:
----------
Total Downloads: 19
First Release: Nov 23, 2025
Last Update: Yesterday at 11:07 PM
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings