SxCore

SxCore is an enterprise-grade, high-performance Minecraft Core Plugin engineered specifically for PaperMC 1.21+ and Folia. Built from the ground up with strict SOLID principles, completely asynchronous database pooling (HikariCP), and MiniMessage RGB gradients, SxCore replaces 10+ bloated individual plugins with one seamless, zero-lag powerhouse.

Whether you run a 500+ player high-concurrency Folia network or a private survival server, SxCore delivers a polished, top-tier commercial resource experience with zero TPS drops and 100% thread-safe architecture.

---

🌟 Why Choose SxCore?

• ⚡ Native Folia & Paper Support: Built-in multi-threaded region and entity scheduler adapters (SchedulerUtils). Runs scheduled tasks without main-thread blocking or region crashes.
• 🗄️ Multi-Database Async Pooling: Supports SQLite (WAL Mode), MySQL, MariaDB, and H2 with automatic runtime DDL schema migrations. Every read and write runs asynchronously in background threads.
• 🎨 100% MiniMessage & RGB Gradients: Say goodbye to ugly vanilla text! Every menu, chat alert, and action bar features smooth hex gradients, Small Caps Unicode font styling, and custom particle/sound cues.
• 🛡️ Airtight Anti-Dupe Security: Features synchronized atomic auction locks (activeAuctions.remove(...)) and strict GuiManager shift-click/hotbar-swap inventory protection across all open menus.
• 🎛️ Modular Master Switches: Every feature has its own separate .yml config with a master enabled: true/false toggle. Turn off what you don't need instantly!

---

🚀 Complete Module Breakdown

🛒 1. Enterprise Auction House (/ah, /auction)

An ultra-modern 6-Row Paginated Market supporting live cross-viewer synchronization (liveRefreshAllViewers()) whenever an item is listed, sold, or cancelled.

• Sorting & Filtering: Filter by category (Weapons, Armor, Tools, Blocks, Misc) or sort by Newest, Oldest, Price: Low to High, and Price: High to Low.
• Interactive Chat Keyword Search: Click the search tag icon and type any keyword in chat to filter item names or seller names instantly.
• Expired & Cancelled Storage (/ah expired): Unclaimed items reside safely in an offline storage buffer with a one-click [Claim All] sweep.
• Taxes & Safeguards: Configurable tax percentage (5.0%), Vault economy hook, and a dedicated Buy Confirmation Menu (AuctionBuyConfirmGui) to prevent accidental purchases.
• Admin Management (/ah admin): Admins can shift-right-click any active listing to remove/refund it immediately.

---

✈️ 2. Stateful Clickable TPA System (/tpa, /tpahere, /tpaccept, /tpdeny, /tpacancel)

• Strict Anti-Spam State Locking: If Player A sends a request to Player B, they cannot send duplicate requests until Player B accepts, declines, or the request expires (timeout-seconds: 60).
• Clickable Chat & Confirmation GUI (TpaAcceptGui): Receiver gets a hoverable prompt:
  [✔ Accept] [✖ Decline]
  Clicking [✔ Accept] or typing /tpaccept opens a 3-Row Confirmation GUI triggering portal particles and enderman teleport sounds upon confirmation.
• Granular Settings Toggles: Players can separately toggle incoming /tpa requests vs /tpahere requests in their /settings menu.

---

🏰 3. Team Management Hierarchy (/team)

Create and manage player teams (/team create <name>) with structured role hierarchies (Leader > Co-Owner > Elder > Member).

• Interactive Management Menu (TeamGui): Displays online/offline player skull heads. Left-click to Promote, right-click to Demote, and shift-right-click to Kick.
• Friendly Fire & Waypoints: Toggle team PvP protection (Default: OFF for safe team mining) and set shared Team Home coordinates (/team sethome, /team home) with a live ActionBar countdown timer.
• Internal Team Chat (#<message> or /team chat): High-end internal gradient communication broadcasted exclusively to teammates.

---

🌍 4. Safe Random Teleport (/rtp & /worlds)

• Async Location Scanner: Scans chunk columns within configurable bounds (min-radius: 100, max-radius: 10,000+ per dimension).
• 100% Hazard-Free: Strictly avoids Water, Lava, Leaves, Cactus, Magma Blocks, Fire, Campfires, Bedrock, and Void.
• Dark Visual Screen Transition: Applies a temporary DARKNESS and BLINDNESS potion transition effect accompanied by big on-screen Title & Subtitle countdown timers (3s, 2s, 1s) before arriving.

---

🏠 5. Personal Homes & Server Spawns (/home, /sethome, /spawn)

• Personal Waypoints Menu (HomeGui): Type /home or /homes to open a 4-Row menu displaying all set homes with bed/door icons and exact coordinates. Left-click to teleport, shift-right-click to delete, or click [+ SET NEW HOME].
• Rank-Based Limits: Normal players get 1 Home by default (sxcore.homes.limit.1), while VIPs and Admins can be granted up to .3, .5, .10, .20, or .unlimited homes.
• Server Spawns (/spawn [name]): Multi-spawn waypoint system backed by sxcore_spawns with an optional Confirmation Screen (SpawnConfirmGui).

---

🛡️ 6. Player Settings GUI (/settings)

An ultra-modern 4-Row Preferences HUD featuring genuine Minecraft item icons, glowing <green>ON</green> / <red>OFF</red> status switches, and a one-click Factory Reset (Slot 31) switch:

• 🔮 Incoming /tpa Requests (Ender Pearl)
• 👁️ Incoming /tpahere Requests (Ender Eye)
• 💎 Fast Crystal PvP (End Crystal)
• 🎵 Sound Effects (Note Block)
• 🔥 Particle Effects (Blaze Powder)
• 📖 Chat Formatting (Book)
• 📜 Private Messages (Paper)
• 🖼️ Scoreboard HUD (Item Frame)
• 🍎 Auto Accept TPA (Golden Apple)

---

👤 7. Combat & Statistics HUD (/profile [player])

A 4-Row character inspection menu rendering the target player's skull head, Combat Stats (Kills, Deaths, exact KDR), Total Session Playtime (TimeUtils), First Join Date, Vitals (Health, Food, XP Level), Rank (LuckPerms), Balance (Vault), and Exact World/Coordinates.

---

💎 8. Expanded 6-Row Ender Chests (/ec, /enderchest)

• Universal 6 Lines (54 Slots): Replaces vanilla 3-row chests with an expanded 54-slot custom inventory synchronized across all access points.
• Physical Block Connection (EnderChestListener): When a player physically right-clicks any Ender Chest block (Material.ENDER_CHEST) placed inside the world, SxCore intercepts the interaction (EventPriority.LOWEST) and opens our custom 6-line database chest instead!
• Admin Inspection: Admins can type /ec <playername> (sxcore.command.enderchest.others) to view and modify the persistent 6-line ender chest of any online or offline player!

---

⚡ 9. Fast Crystal PvP Module (com.sxcore.modules.fastcrystal)

Controlled by the player's /settings switch and sxcore.fastcrystal.use permission, this module eliminates vanilla crystal placement cooldowns (setCooldown(Material.END_CRYSTAL, 0)) and entity hit delays (player.setNoDamageTicks(0)) inside permitted worlds (pvp_arena, world_the_end, etc.) for zero-delay crystal PvP!

---

🧹 10. Automated Lag Cleaner (/cleaner, /lagclean)

• Smart Entity & Item Sweep: Automatically runs at periodic intervals (300s) with countdown warning broadcasts in Chat and ActionBar (60s, 30s, 10s, 5s, 3s, 2s, 1s).
• Standard Hostile Isolation: When clean-hostile-mobs: true is enabled, it strictly targets only standard monsters (ZOMBIE, SKELETON, CREEPER, ENDERMAN, BLAZE, etc.).
• 100% Nametag & Pet Safeguard: Any mob with a Custom Nametag (getCustomName() != null), or that is Persistent (isPersistent()), Tamed (isTamed()), or carrying a Passenger is completely immune and will never be deleted by the cleaner!

---

💰 11. Shop Worth Detection (/worth)

• Automatic Reflection Bridge (ShopManager): Detects EconomyShopGUI, ShopGUIPlus, or EssentialsX Worth cleanly via reflection without requiring external build dependencies.
• Dynamic Lore Injection (ItemWorthUtils): Whenever players open their inventory, chest, or ender chest, SxCore appends the live unit/stack sell value right onto the item lore:
  Worth » $12,800.00 ($200.00 each)
• Command Inspection: Run /worth hand to inspect held item value or /worth all to sum the total monetary value of all sellable items across your inventory!

---

💬 12. Private Messaging Suite (/msg, /reply)

• Send private whispers (/msg <player> <message>, /tell, /w) or quick replies (/reply <message>, /r) with glowing YOU » PlayerA: Hello! formatting and audio chime notifications. Respects the receiver's /settings Private Messages toggle!

---

🛠️ Complete Modular Configuration Files

Every feature is fully customizable via 14 separate YAML files located in /plugins/SxCore/:

• config.yml (Prefix, debug toggles, pool sizes, fast-crystal worlds)
• messages.yml (Clickable chat prompts, error alerts, prefix strings)
• menus.yml (TPA confirmation and spawn confirmation button items)
• database.yml (HikariCP options: SQLITE, MYSQL, MARIADB, H2 host settings)
• auction.yml (Min/Max prices, taxes, blacklists, category definitions)
• rtp.yml (Per-world radii up to 10,000+ blocks, active dimensions)
• team.yml (Creation costs, friendly fire defaults, roles, home cooldowns)
• homes.yml (Personal home limits, countdown timers, GUI borders)
• spawn.yml (Default spawn point names, GUI triggers)
• settings.yml (4-Row preferences layout and default player preferences)
• cleaner.yml (Timer intervals, warning schedules, whitelisted item materials)
• enderchest.yml (Default and max row sizing)
• fastcrystal.yml (Placement delay ticks, permitted worlds)
• worth.yml (Shop detection lore formats and inventory auto-update toggles)

---

🔐 Permissions Reference (Default vs Admin)

All standard commands are granted to regular players (default: true) out of the box, while administrative commands are strictly locked (default: op):

🟢 Standard Player Permissions (default: true)

Permission Node	Granted Access
sxcore.player.*	Grants all non-OP standard commands (/tpa, /ah, /team, /rtp, /home, /settings, /profile, /worth, /msg, /spawn)
sxcore.command.tpa / tpahere / tpaccept / tpdeny	Teleport request commands (/tpa, /tpahere, /tpaccept, /tpdeny, /tpacancel)
sxcore.command.settings / tpatoggle	Player preferences GUI (/settings, /tpatoggle)
sxcore.command.ah	Auction House market (/ah, /auction, /ah sell, /ah expired)
sxcore.command.rtp	Random teleportation GUI (/rtp)
sxcore.command.team	Team creation and management (/team)
sxcore.command.profile	Combat & session HUD (/profile)
sxcore.command.spawn	Teleport to server spawn (/spawn)
sxcore.command.home / sethome / delhome	Personal waypoints system (/home, /sethome, /delhome)
sxcore.command.worth	Shop value inspector (/worth [hand|all])
sxcore.command.msg / reply	Private whispers (/msg, /reply, /r)
sxcore.homes.limit.1	Sets default personal home limit to 1
sxcore.auction.listings.5	Sets default simultaneous auction listings limit to 5

🔴 Administrative Permissions (default: op)

Permission Node	Granted Access
sxcore.* / sxcore.admin.*	Master Wildcard – Grants all administrative & player permissions
sxcore.command.sxcore	Main admin command (/sxcore reload|stats|version)
sxcore.command.tp / tphere / tppos	Admin coordinate & player teleportation (/tp, /tphere, /tppos)
sxcore.command.worlds	Enable/disable RTP dimensions (/worlds enable|disable <world>)
sxcore.command.setspawn / delspawn	Create/delete server spawn waypoints (/setspawn, /delspawn)
sxcore.command.cleaner	Manual lag cleaner sweep (/cleaner now|status)
sxcore.command.ah.admin	Admin management inside /ah admin (Shift-right-click remove item)
sxcore.command.enderchest	Command access to /ec and /enderchest (default: op)
sxcore.command.enderchest.others	Admin inspection of any player's ender chest (/ec <playername>)
sxcore.fastcrystal.use	Enables instant crystal PvP placement when /settings switch is ON
sxcore.homes.limit.3 / .5 / .10 / .unlimited	VIP/Admin personal home limits
sxcore.auction.listings.10 / .15 / .unlimited	VIP/Admin simultaneous auction listing limits
sxcore.bypass.cooldown / tpatoggle	Bypasses command cooldowns and player TPA toggles

---

📦 How to Install

1. Download SxCore-1.0.0-PREMIUM.jar and drop it inside your server's /plugins/ folder.
2. (Optional) Place PlaceholderAPI.jar, Vault.jar, LuckPerms.jar, plus your favorite Economy provider inside /plugins/.
3. Start your PaperMC 1.21+ or Folia server. SxCore will automatically generate all 14 configuration files and establish HikariCP connection pools (sxcore_data.db).
4. Run /sxcore reload anytime to hot-reload all configurations asynchronously!