TheSmp

TheSmp is an all-in-one Paper core for survival servers, SMP communities and private networks. It combines player utilities, social systems, economy integration, progression, quests and staff moderation without requiring dozens of separate plugins.

Every important system is configurable, player data is stored locally and four languages are included.

MAIN FEATURES

• Server spawn — Persistent global spawn with /spawn and /setspawn.
• Homes — Multiple named homes with permission-based limits and a clean GUI.
• Teleport requests — /tpa, /tphere, /tpallow and /tpdeny with expiration and warmups.
• Random teleport — Asynchronous terrain search, safety checks and cooldowns.
• Server warps — GUI, individual permissions and administration commands.
• Back and ignore — Return to previous locations and block unwanted interactions.
• Friends — Requests, online status, private friend messages, quick TPA and notifications.
• Private messaging — /msg, /reply and /r for any online player.
• Clans — GUI, roles, clan homes, shared bank, levels, points and rankings.
• Reports — Categories, recorded context and full staff moderation workflow.
• Moderation — Persistent warnings, temporary mutes and player history.
• Secure trading — Shared inventory requiring confirmation from both players.
• Welcome system — Separate first-join and regular messages with optional commands.
• Custom commands — Register commands and aliases directly from config.yml.
• TAB completion — Configurable suggestions for commands and every argument.
• Configurable menus — Unlimited GUIs with items, permissions and actions.
• Vault economy — Optional costs for homes, warps, RTP and clan creation.
• Player profiles — Playtime, kills, deaths, friends, clan and last connection.
• Daily rewards — Persistent streaks and configurable milestone bonuses.
• Daily and weekly quests — GUI, tracked objectives and configurable rewards.
• Player sitting — /sit with safe cleanup and Shift to stand.
• Spectator TAB privacy — Hide spectators while authorized staff retain visibility.
• Visual guide — /thesmp opens a complete interactive guide.
• Multilingual — English, Spanish, Portuguese and French included.
• Persistent YAML storage — No external database required.
• No required dependencies

SPAWN SYSTEM

Administrators set a precise global spawn with /setspawn. Players return using /spawn after the configurable teleport warmup.

The location is stored in data.yml. Moving or taking damage during the warmup cancels teleportation, preventing instant escapes.

HOMES AND TELEPORTATION

Players can create named homes, browse them from an inventory and teleport or delete them with clicks. Limits are controlled through permissions.

TPA requests support expiration, acceptance, rejection and requests that bring another player to you. RTP searches asynchronously for safe terrain without freezing the server.

FRIENDS AND MESSAGING

/friends opens an interactive dashboard with the friend list and pending requests. Players can send, accept, reject and remove friendships, see online status, send friend-only messages and quickly request teleportation.

The global private-message system works independently from friendships. /reply remembers the last conversation while both players remain online.

REPORT MODERATION

Players can use /report <player> to choose a category from a menu, or /report <player> <reason> for a quick custom report.

The /reports staff dashboard contains three independent sections:

• Pending — New reports and reports under review.
• Resolved — Valid reports that staff have handled.
• Rejected — Random, false or invalid reports.

Every report stores the reporter, target, category, reason, date and location context. Staff can inspect details, change status, reopen reports or teleport to an online target.

CLAN SYSTEM

The integrated clan system lets players create and manage communities from a polished inventory interface.

• Unique names and tags
• Leader, officer and member roles
• Invitations with expiration
• Member management
• Private clan chat with /cc
• Alliance chat with /ac
• Configurable size and friendly fire

WELCOME SYSTEM

Welcome messages can be enabled or disabled globally. First-time and returning players can receive different messages, either privately or as a broadcast.

Optional player or console commands can run when a player joins. Vanilla join and quit messages are hidden by default through welcome.hide-vanilla-messages to prevent duplicates.

Available placeholders include %player%, %world%, %online% and %max%.

CUSTOM COMMANDS AND TAB COMPLETION

Register custom commands directly in config.yml without editing Java. Every command supports aliases, permissions, private messages, broadcasts and actions executed as the player or console.

Custom commands and menu open commands appear when players type /. Suggestions can be configured separately for every argument. Use %players% to automatically suggest all online players. Suggestions respect permissions.

Available placeholders include %player%, %world%, %args%, %arg1%, %arg2% and more.

CUSTOM MENUS

Create unlimited inventory menus inside menus.yml. Every item can define its own material, slot, display name, lore and permission.

Supported actions:

• Private messages
• Server broadcasts
• Player commands
• Console commands
• Open another menu
• Titles and subtitles
• Close the inventory

Menu placeholders include %player%, %world%, %x%, %y% and %z%.

LANGUAGE SYSTEM

Translations are organized inside the lang folder:

/lang opens the personal language selector for each player. /langg lets administrators select the global fallback. Existing installations using lang.yml are migrated automatically and new keys are merged without overwriting customized messages.

WARPS, BACK AND IGNORE

Create server warps with individual permissions and an interactive /warps GUI. /back returns players to their previous teleport or death location. /ignore blocks unwanted private interactions and persists after restarts.

VAULT ECONOMY

Vault integration is optional. Configure independent costs for creating homes, using warps, random teleport and clan creation. A cost of 0 disables payment for that action. Vault and an economy plugin are only required when at least one cost is enabled.

MODERATION TOOLS

Staff can create persistent warnings, inspect warning history, apply temporary chat mutes and remove them. /history combines warnings and active mute information for fast moderation.

ADVANCED CLANS

Clans now support a shared home, a Vault-backed clan bank, persistent levels and points, and a global ranking.

PLAYER PROFILES

/profile [player] displays online status, playtime, player kills, mob kills, deaths, friend count, clan information and last connection.

DAILY REWARDS

/daily claims the current reward while /rewards opens an interactive menu. Streaks persist between restarts. Normal rewards and milestone bonuses run configurable console commands with %player% and %streak% placeholders.

DAILY AND WEEKLY QUESTS

/quests opens a progress GUI. Create unlimited daily or weekly objectives in config.yml using playtime, mob kills, player kills or deaths. Completed quests can be claimed once per period and execute configurable reward commands.

COMMANDS

PERMISSIONS

CONFIGURATION FILES

• config.yml — Cooldowns, economy, welcomes, commands, TAB suggestions, rewards, quests, friends, reports, RTP, clans and SpectatorTab.
• lang/en.yml, es.yml, pt.yml and fr.yml — Translations.
• menus.yml — Custom inventory menus and actions.
• data.yml — Homes, spawn, languages and friend data.
• reports.yml — Persistent moderation reports.
• clanes.yml — Persistent clan data.
• expansion.yml — Warps, back locations, ignored players, moderation, rewards and quest progress.

Reload configuration with /thesmp reload.

COMPATIBILITY

• Server software: Paper 1.21.x
• Tested version: Paper 1.21.8
• Java: 21 or newer
• LuckPerms: Optional and recommended
• Vault and an economy plugin: Optional for economy costs and clan bank
• PlaceholderAPI: Optional and compatible
• ProtocolLib: Optional and compatible
• TAB: Optional and compatible
• Geyser/Floodgate: Optional and compatible

INSTALLATION

1. Download TheSmp-1.8.0.jar.
2. Place it inside your server's plugins folder.
3. Remove older TheSmp JAR files.
4. Restart your Paper server.
5. Confirm that TheSmp appears in green in /plugins.
6. Customize config.yml, the lang folder and menus.yml when required.