Welcomer

When a player first joins, want them to feel welcome and maybe give them some starting gear. well now you can. If a player joins back maybe give them a custom welcome back message and say how long its been since you’ve seen them. well now you can

## example config

“`yaml

# config.yml
first-join-message: “Welcome to the server! %player%”
welcome-back-message: “Welcome back to the server! You were last seen on %lastseen%”
first-join-items:
– DIAMOND 3
– IRON_SWORD 1
– GOLDEN_APPLE 2
“`

Please consider donating.

WelcomeMessageGUI+

## Version 1.0.0

**Initial Release**

### ✨ Features
– 🎨 **Full Color Support** – Use HEX colors (`&#FF0000`) or standard Minecraft colors (`&a`, `&b`, etc.)
– 💬 **Chat Editor** – Click in GUI, type in chat (supports **Ctrl+V copy-paste!**)
– 🖱️ **Beautiful GUI** – Centered 5-row interface with colored glass borders
– ⚡ **Live Preview** – Test your title before saving
– 🔄 **Config Reload** – Reload settings without restarting
– 🎯 **Smart Input** – Type `cancel` to abort editing
– 💾 **Persistent** – Everything saves to `config.yml`

### 🎮 Commands

| Command | Description |
|———|————-|
| `/welcomemsg` | Open the settings GUI |
| `/welcomemsg reload` | Reload configuration |
| `/welcomemsg preview` | Preview the welcome title |
| `/welcomemsg set title ` | Set title via command |
| `/welcomemsg set subtitle ` | Set subtitle via command |

**Aliases:** `/wm`, `/welcome`

### 🔒 Permission

– `welcomemessage.admin` – Access to all commands and GUI (default: op)

### 🛠️ Installation

1. Download the JAR
2. Place in `plugins/` folder
3. Start server (generates `config.yml`)
4. Edit in-game via GUI or edit `config.yml` manually
5. Enjoy! 🚀

### ⚙️ Config Example

“`yaml
welcome:
title: “&#00FF00Welcome!”
subtitle: “&#FFFFFFHave fun playing!”
enabled: true
fade_in: 30 # Ticks (1.5s)
stay: 70 # Ticks (3.5s)
fade_out: 30 # Ticks (1.5s)
“`

### 🔧 Technical

– MC 1.21+ (Paper/Spigot/Purpur)
– Java 21
– ❌ Not compatible with Fabric/Forge/NeoForge

### Support
If you run to any issues don’t hesitate sending a message to my discord or my website. 🙂

WelcomeAds


WelcomeAds is a customizable Minecraft plugin that enhances player engagement with interactive, inventory-based welcome screens. Create seamless multi-page carousels, integrate custom sounds, and deliver dynamic content effortlessly!


This plugin requires a resource pack to function properly; you can use ItemsAdder, Oraxen, or NexO to create font images, or manually add them to your own resource pack. Check out the wiki here.
You can use Placeholder with ‘PlaceholderAPI’ installed.


– Add as many page as you want
– Auto page scrolling, and you can loop it too.
– Per item commands on click
– Per screen background
– Per screen event checker (inventory open/close) command
– Per screen permission
– Load type setting (on join/ after resourcepack load)
– PlaceholderAPI supported
– Player head with offline player skin supported
– Background fade out when closing the screen
– Hex and minecraft color support. You can use ‘Legacy’ mode for hex generator website.
– Texteffect support (or any Shader working with title text)
– for example, you can use ItemsAdder text effect
– Forcing player to stay on the page
– Custom items with modeldata, lore, name support
– Per session screen showing support


### Installation

– Place the WelcomeAds.jar file in your Minecraft server’s plugins folder.
– Restart or reload your server.
– Configure the plugin settings in the generated config.yml file.
– Install one of these plugins for easier use: ItemsAdder (Example file provided), Oraxen, or NexO. These plugins have custom emoji functions that will be used to display background colors and GUI images.
– If you do not have any of the above plugins, you can still use WelcomeAds, but you will need to manually create a font texture for the background and GUI images.
– Enjoy the custom welcome screen functionality!

### Commands
– welcomeads open – welcomeads reload


This is my practice project, so if you encounter any issues, feel free to report them on GitHub. If you have any suggestions, you’re welcome to contact me via the Discord information provided on my GitHub profile. Thank you for your support!

with love from TiNY <3
found me / get support on discord server: https://discord.gg/JMdjgnzG8W


Welcome Mat

### A friendly way to roll out the welcome mat for your players!

**WelcomeMat** is a lightweight, powerful plugin that enhances your server’s welcome experience. It provides customizable join/leave messages, titles, animations, and sounds to make players feel at home on every login.


## 🎉 What’s New!

### Version 1.3.1 (Latest)
– 🍃 **Folia-Ready Animations**: Visual effects now use the latest Folia entity schedulers (1.21.8+) with automatic signature detection, clamped delays, and no unsafe Bukkit fallbacks.
– 🧠 **Smarter Diagnostics**: If future Folia builds introduce new scheduler signatures, they’re logged automatically so you can keep running the same jar everywhere.
– 🧾 **Auto Version Metadata**: `plugin.yml` now inherits the Gradle version, guaranteeing accurate version strings inside the jar.
– 🌌 **Skyward & Copper Packs**: Two new message packs inspired by the 1.21 “Chase the Skies” and “Copper Age” updates, selectable right from the GUI.

### Version 1.2.x Highlights
– **Message Packs System**: Multiple themed collections (default, friendly, professional, funny, RPG) with GUI switching.
– **Multi-Language Support**: English and Spanish out of the box with easy CLI/GUI selection.
– **Improved Configuration Display**: Human-friendly display names and cleaner GUI organization.

—

## 🔄 Compatibility

– Fully tested on **Bukkit/Spigot, Paper, Purpur, and Folia** from **Minecraft 1.13 through 1.21.10**.
– Region-aware scheduler paths keep Folia’s watchdog happy while the same jar continues to run flawlessly on single-threaded servers.

—

## Features

– 🎨 **Customizable Messages**
– Rich join/leave text with color codes and placeholders
– Player-specific greetings and per-pack collections
– Display-name helpers and multi-language support (EN/ES)

– 📜 **Welcome Titles**
– Configurable title/subtitle timing and colors

– 🔊 **Interactive Sounds**
– Join/leave sounds with per-player toggles, volume, and pitch

– ✨ **Animation System**
– Fire Spiral, Green Spike Firework, and more join effects
– Folia-safe schedulers and per-player animation preferences

– ⚙️ **Extensive Configuration**
– Feature toggles, admin logging, instant `/wm reload`
– GUI-driven settings for packs, languages, sounds, and more

## 📋 Commands

– `/welcomemat` or `/wm` – Base command
– `/wm sound` – Toggle join/leave sounds for yourself
– `/wm reload` – Reload the plugin configuration
– `/wm help` – Show help message
– `/wm animation` – Toggle join animations for yourself
– `/wm language` – Change the plugin language
– `/wm pack` – Change the message pack
– `/wm config` – Modify plugin configuration

## 🔑 Permissions

– `welcomemat.reload` – Allow reloading the configuration (default: op)
– `welcomemat.bypass` – Bypass welcome messages (default: false)
– `welcomemat.sound.toggle` – Allow toggling sounds (default: true)
– `welcomemat.animation.toggle` – Allow toggling animations (default: true)
– `welcomemat.admin.log` – Receive admin log messages (default: op)
– `welcomemat.language` – Allow changing the plugin language (default: op)
– `welcomemat.pack` – Allow changing message packs (default: op)
– `welcomemat.config` – Allow modifying plugin configuration (default: op)

## 📦 Installation

1. Download the latest version of WelcomeMat
2. Place the `.jar` file in your server’s `plugins` folder
3. Restart your server
4. Configure the plugin in `plugins/WelcomeMat/config.yml`

## ⚙️ Configuration

“`yaml
features:
join-message: true
leave-message: true
join-title: true
join-sound: true
leave-sound: true
other-players-sounds: true
join-animation: true
admin-logging: true

messages:
join: “&e%player% &ajust joined the server!”
leave: “&e%player% &chas left the server!”
player-specific:
example-player:
join: “&6Welcome back, special player %player%!”
leave: “&eGoodbye, special player %player%!”

titles:
join:
title: “&6Welcome!”
subtitle: “&eEnjoy your stay!”

sounds:
join:
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.0
leave:
sound: ENTITY_IRON_GOLEM_DEATH
volume: 0.5
pitch: 1.0

animations:
green-spike:
enabled: true
duration: 40
height: 2.0

# Message Packs
message-packs:
# Currently selected pack (default, friendly, professional, funny, rpg)
selected: “default”

# Default pack (original messages)
default:
join:
– “&e%player% &ajust joined the server!”
leave:
– “&e%player% &chas left the server!”

# Friendly pack
friendly:
join:
– “&d✨ &e%player% &ahas joined the party! &d✨”
– “&aWelcome back, &e%player%&a! We missed you! &d❤”
leave:
– “&e%player% &7had to go… &cSee you soon! &d💕”
– “&7Until next time, &e%player%&7! &d👋”
“`

## 🌐 Language Support

WelcomeMat now supports multiple languages:

“`yaml
# Available languages: english, spanish
selected-language: “english”

languages:
english:
name: “English”
messages:
reload:
success: “&aConfiguration reloaded successfully!”
sound:
enabled: “&aJoin/leave sounds enabled!”
disabled: “&cJoin/leave sounds disabled!”
spanish:
name: “Español”
messages:
reload:
success: “&a¡Configuración recargada con éxito!”
sound:
enabled: “&a¡Sonidos de entrada/salida activados!”
disabled: “&c¡Sonidos de entrada/salida desactivados!”
“`

## 🎵 Available Sounds

### Modern (1.13+)
– `ENTITY_PLAYER_LEVELUP`
– `ENTITY_IRON_GOLEM_DEATH`
– `BLOCK_NOTE_BLOCK_PLING`
– `BLOCK_NOTE_BLOCK_CHIME`
– `BLOCK_NOTE_BLOCK_BELL`
– And more…

### Legacy (1.8-1.12) (Under development)
– `LEVEL_UP`
– `IRONGOLEM_DEATH`
– `NOTE_PLING`
– `NOTE_PIANO`
– And more…

## 💡 Example Configurations

### Professional Server with Message Packs
“`yaml
# Use the professional message pack
message-packs:
selected: “professional”

# Set the language to English
selected-language: “english”

sounds:
join:
sound: BLOCK_NOTE_BLOCK_PLING
volume: 0.8
pitch: 1.5

animations:
green-spike:
enabled: true
duration: 30
height: 1.5
“`

### VIP Server with Custom Messages
“`yaml
messages:
join: “&d✨ &e%player% &ahas joined the party! &d✨”
leave: “&e%player% &7had to go… &cSee you soon!”
player-specific:
VIP_Player:
join: “&6⚡ The legendary &e%player% &6has arrived! ⚡”
leave: “&6The legend &e%player% &6must go… &7Until next time!”

sounds:
join:
sound: ENTITY_PLAYER_LEVELUP
volume: 1.0
pitch: 1.2

animations:
green-spike:
enabled: true
duration: 50
height: 2.5
“`

## 📝 Support
If you encounter any issues or have suggestions:
– Create an issue on our [GitHub repository](https://github.com/coffeeisle/welcome-mat)
– Join our [Discord server](https://discord.gg/cJ4uP2xF7h)

—

Made with ❤️ by angeldev0

[Download](https://modrinth.com/plugin/welcome-mat) • [Source](https://github.com/coffeeisle/welcome-mat) • [Discord](https://discord.gg/cJ4uP2xF7h)

Welcome++

# 🎉 Welcome++ – The ULTIMATE Minecraft Plugin!

**Transform your server with 50+ incredible features in one lightweight plugin!**

Welcome++ is the most comprehensive server enhancement plugin available, packed with everything you need to create an amazing multiplayer experience. From custom welcome messages to advanced weapons, vehicles, economy systems, and mini-games – this plugin has it all!

## ✨ **Key Features**

### 🎯 **Core Features**
– **Custom Welcome & Leave Messages** – Personalized greetings with player placeholders
– **Fake Names** – Let players change their display names and nametags
– **Player Heads** – Get any player’s head as an item
– **Color Chat Support** – Use color codes in chat messages

### ⚔️ **Advanced Weapons System**
– **Laser Gun** – High-tech energy weapon with particle effects
– **Rocket Launcher** – Explosive projectile weapon
– **Sniper Rifle** – Long-range precision weapon
– **Shotgun** – Close-range spread damage
– All weapons have cooldowns and custom damage values

### 🚗 **Vehicle System**
– **Planes** – Flyable aircraft with upgrade system (3 levels)
– **Cars** – Ground vehicles for fast travel
– **Speed Boats** – Enhanced water transportation
– **Helicopters** – Advanced flying vehicles
– Upgradeable plane system with speed boosts

### 💰 **Complete Economy System**
– **Money Management** – Full player economy with balances
– **Player-to-Player Payments** – Send money to other players
– **Shop System** – Buy items with in-game currency
– **Money Display in Chat** – Show player balance in chat
– Configurable starting money and limits

### 🌍 **Teleportation & Navigation**
– **Home System** – Set and teleport to your home
– **Warp Points** – Create public teleportation points
– **Random Teleport** – Explore new areas instantly
– **Teleport Cooldowns** – Configurable with bypass permissions
– Safe teleportation with world boundaries

### 🐾 **Cosmetics & Pets**
– **Pet System** – Spawn loyal companions (wolves, cats, parrots, rabbits)
– **Particle Trails** – Fire, heart, star, and rainbow effects
– **Hat System** – Wear any item as a hat
– **Auto-following pets** with smart teleportation

### 🎮 **Mini-Games**
– **Parkour System** – Timed challenges with checkpoints
– **Racing** – Competitive gameplay modes
– **Leaderboards** – Track best times and scores
– **Rewards** – Earn money for completing challenges

### 🛠️ **Utility Commands**
– **Flight Toggle** – Creative-style flying
– **God Mode** – Invincibility toggle
– **Heal & Feed** – Instant health and hunger restoration
– **Speed Control** – Adjustable walk speed (1-10)
– **Admin Tools** – Comprehensive server management

### 🎆 **Fun Commands**
– **Fireworks** – Launch colorful explosions
– **Lightning Strikes** – Call down thunder
– **Explosions** – Create safe TNT-like effects
– **Particle Effects** – Visual enhancements everywhere

## 🔧 **Technical Details**

– **Minecraft Versions:** 1.13 – 1.21.x (Full compatibility)
– **Server Software:** Paper, Bukkit, Purpur, Spigot
– **Dependencies:** None required (ProtocolLib optional)
– **Performance:** Lightweight and optimized
– **Configuration:** Fully customizable via config.yml

## 📋 **Quick Setup**

1. **Download** WelcomePlusPlus-2.1.0.jar
2. **Upload** to your server’s `plugins/` folder
3. **Restart** your server
4. **Configure** messages: `/welcome “Welcome {player}!”`
5. **Enjoy** all 50+ features instantly!

## 🎯 **Command Examples**

“`
/welcome “🎉 Welcome to our server, {player}! 🎉”
/leave “👋 {player} left the server!”
/gun – Get a laser gun
/plane – Spawn a flyable plane
/sethome – Set your home location
/money – Check your balance
/pet wolf – Get a wolf companion
/trail fire – Enable fire particle trail
/fly – Toggle flight mode
/parkour start – Begin parkour challenge
“`

## 🔐 **Permissions System**

Comprehensive permission system with sensible defaults:
– **Players** get basic features (teleportation, pets, trails, parkour)
– **OPs** get advanced features (weapons, vehicles, admin commands)
– **Fully customizable** – adjust any permission as needed

## ⚙️ **Configuration**

Extensive configuration options:
– Custom welcome/leave messages
– Economy settings (starting money, limits)
– Weapon damage and cooldowns
– Teleportation cooldowns and distances
– Pet behavior settings
– Particle trail customization
– Shop prices and items

## 🚀 **Why Choose Welcome++?**

✅ **All-in-One Solution** – Replace 10+ plugins with one
✅ **Lightweight** – Optimized performance, minimal server impact
✅ **Regular Updates** – Active development and bug fixes
✅ **Easy Setup** – Works out of the box, no complex configuration
✅ **Extensive Features** – 50+ commands and features
✅ **Wide Compatibility** – Supports 1.13-1.21.x
✅ **Professional Quality** – Clean code, proper error handling

## 📊 **Perfect For**

– **Survival Servers** – Enhanced gameplay with economy and teleportation
– **Creative Servers** – Fun tools and cosmetic features
– **Mini-game Servers** – Built-in parkour and racing systems
– **PvP Servers** – Advanced weapons and combat features
– **Community Servers** – Social features and player interaction tools

## 🔄 **Version 2.1.0 Features**

This massive update includes:
– Complete economy system with money management
– Advanced weapon arsenal (4 different weapons)
– Full vehicle system with upgrades
– Comprehensive teleportation suite
– Pet and cosmetic systems
– Mini-game framework
– 30+ new commands
– Enhanced configuration options

## 📞 **Support**

Need help? Check out:
– In-game `/help` command for all features
– Comprehensive permission system
– Detailed configuration file
– Active community support

—

**Download Welcome++ today and transform your Minecraft server into the ultimate multiplayer experience!**

*Compatible with Minecraft 1.13 – 1.21.x | Works on Paper, Bukkit, Purpur, Spigot*

Magical Login/Register Skript

**Give your players a first impression they’ll never forget! This elegantly designed Skript transforms the moment a player joins your server into a magical experience. With a stunning, centered welcome message, newcomers instantly feel at home, while returning players are smoothly guided to log in.**

**No more confusing logins or impersonal joins—every message, color, and animation is fully customizable to match your server’s unique style. Lightweight, powerful, and fully compatible with Minecraft 1.21.4, this Skript is perfect for servers of any size, from cozy communities to massive public realms.**

**Runs smoothly on Aternos! To use it there, simply install the Skript plugin, and you’re ready to go.**

**Elevate your server’s onboarding, captivate your players, and give every join a professional, polished touch. Make each player feel like a hero from the very first moment!**

**Join our community for support, updates, and exclusive tips: [https://discord.gg/Q89W2ebg](https://discord.gg/Q89W2ebg)**

**▶️ Watch tutorials and updates on YouTube: [https://youtube.com/@ninja_gamerz2692](https://youtube.com/@ninja_gamerz2692)**

1️⃣ Requirements:

Spigot server (1.21.4 recommended)

Skript plugin .jar file (download: Skript Releases)

Your .sk Skript file

2️⃣ Install Skript Plugin:

Put Skript.jar into your server’s plugins folder.

Start the server.

plugins/Skript folder will be created automatically.

3️⃣ Upload Your Skript:
Unarchive this zip

And..
Place your .sk file into plugins/Skript/scripts/.

**new plugin is here:**
https://modrinth.com/project/7y8POuIN

Weights of Items

# Weight of Items
“`
This plugin introduces a new mechanic to the game – the weight of items.
Now each item has its own weight, which is added to the player’s inventory.
The more weight you carry, the more your movement is slowed down.
If the weight exceeds the critical mark, the player will not be able to move at all.
Keep an eye on your equipment to stay mobile!
“`

**Full customization for your server!**

Everything in this plugin can be finely tuned to the needs and atmosphere of your project!
Flexible effects settings: You set yourself at what weight the player starts to slow down, how strong this slowdown will be, and at what value he will be completely immobilized.

Control over each item: You can assign an individual weight to any item in Minecraft – from a feather to a gold ingot. Make some things light and others really heavy to create a balanced and unique weight economy.

The plugin gives administrators full control to create the perfect gaming experience.

### Commands:
“/reload“- restarts the plugin localization and config

### Permissions:
“weightofitems.reload“ – the ability to restart the plugin

“weightofitems.bypass“ – the ability to bypass weight restrictions

### Placeholders:
“%player_weight%“ – returns the player’s weight

“%player_weight_colored%“ – returns the weight of the player with the appropriate color

“%max_weight%“ – returns the maximum weight value from the config setting

“%high_weight%“ – returns the high weight value from the config setting

“%medium_weight%“ – returns the medium weight value from the config setting

WeGuardian

# 🛡️ WeGuardian

Professional Punishment Management System for Minecraft Servers
by WeThink

—

## ✨ Features

### 🔨 Punishment System
– **Ban & TempBan** – Permanently or temporarily ban players
– **IP Ban & TempIP Ban** – Ban players by IP address with automatic IP resolution
– **Mute & TempMute** – Silence players permanently or temporarily
– **IP Mute & TempIP Mute** – IP-based muting system
– **Kick** – Instantly remove players from the server

### 🎮 Interactive GUI
– **Punishment GUI** – Beautiful and intuitive punishment selection interface
– **Duration Selector** – Easy-to-use duration selection with presets
– **History Viewer** – Browse punishment history with pagination

### 📊 Database Support
– **SQLite** – Zero-configuration local storage (default)
– **MySQL** – Scale to larger servers with MySQL support
– **HikariCP** – High-performance connection pooling
– **Caffeine Caching** – Lightning-fast data retrieval

### 🌐 Web Dashboard
– Built-in web panel for remote management
– REST API for custom integrations
– Configurable branding and appearance

### 🔗 Discord Integration
– Webhook logging for all punishments
– Batched messages to avoid rate limits
– Beautiful embed formatting

### ⚡ Performance
– **Folia Support** – Full compatibility with Folia servers
– **Async Operations** – Non-blocking database operations
– **Lazy GUI Initialization** – Optimized GUI performance

—

## 📥 Installation

1. Download the latest `WeGuardian.jar`
2. Place it in your server’s `plugins` folder
3. Restart your server
4. Configure `plugins/WeGuardian/config.yml`

—

## 📝 Commands

| Command | Description | Permission |
|———|————-|————|
| `/ban [reason]` | Permanently ban a player | `weguardian.ban` |
| `/tempban [reason]` | Temporarily ban a player | `weguardian.tempban` |
| `/unban ` | Unban a player | `weguardian.unban` |
| `/banip [reason]` | IP ban a player | `weguardian.banip` |
| `/tempbanip [reason]` | Temp IP ban a player | `weguardian.tempbanip` |
| `/unbanip ` | Unban a player’s IP | `weguardian.unbanip` |
| `/mute [reason]` | Permanently mute a player | `weguardian.mute` |
| `/tempmute [reason]` | Temporarily mute a player | `weguardian.tempmute` |
| `/unmute ` | Unmute a player | `weguardian.unmute` |
| `/muteip [reason]` | IP mute a player | `weguardian.muteip` |
| `/tempmuteip [reason]` | Temp IP mute a player | `weguardian.tempmuteip` |
| `/unmuteip ` | Unmute a player’s IP | `weguardian.unmuteip` |
| `/kick [reason]` | Kick a player | `weguardian.kick` |
| `/punish ` | Open punishment GUI | `weguardian.punish` |
| `/history ` | View punishment history | `weguardian.history` |
| `/weguardian reload` | Reload configuration | `weguardian.admin` |

—

## 🔑 Permissions

| Permission | Description | Default |
|————|————-|———|
| `weguardian.staff` | All staff permissions | OP |
| `weguardian.admin` | Admin commands (reload) | OP |
| `weguardian.bypass` | Bypass all punishments | false |

—

## ⏱️ Duration Format

Durations support the following formats:

| Unit | Example | Description |
|——|———|————-|
| `s` | `30s` | Seconds |
| `m` | `30m` | Minutes |
| `h` | `6h` | Hours |
| `d` | `7d` | Days |
| `w` | `2w` | Weeks |
| `M` | `1M` | Months |
| `y` | `1y` | Years |

**Examples:** `1h`, `6h`, `1d`, `7d`, `30d`, `90d`

—

## ⚙️ Configuration

### Database (SQLite – Default)
“`yaml
database:
type: “sqlite”
sqlite:
file: “punishments.db”
“`

### Database (MySQL)
“`yaml
database:
type: “mysql”
mysql:
host: “localhost”
port: 3306
database: “weguardian”
username: “root”
password: “password”
“`

### Discord Webhook
“`yaml
discord:
enabled: true
webhook-url: “YOUR_WEBHOOK_URL”
batch-interval-seconds: 5
“`

### Web Dashboard
“`yaml
web-dashboard:
enabled: true
host: “0.0.0.0”
port: 8080
admin-api-key: “YOUR_SECURE_KEY”
“`

—

## 🛠️ Requirements

– **Minecraft Server:** Paper 1.21+ or Folia
– **Java:** 21 or higher

—

## 📚 Dependencies

– [Paper API](https://papermc.io/) – Server API
– [FoliaLib](https://github.com/TechnicallyCoded/FoliaLib) – Folia compatibility
– [Caffeine](https://github.com/ben-manes/caffeine) – Caching
– [HikariCP](https://github.com/brettwooldridge/HikariCP) – Connection pooling
– [ACF](https://github.com/aikar/commands) – Command framework
– [FastInv](https://github.com/MrMicky-FR/FastInv) – GUI framework
– [bStats](https://bstats.org/) – Plugin metrics
– [Javalin](https://javalin.io/) – Web framework

—

## 📞 Support

For support and questions, join our Discord or open an issue on GitHub.

—

## 📄 License

This project is licensed under the MIT License. See [LICENSE.md](LICENSE.md) for details.

—

Made with ❤️ by WeThink

WebStats


**View statistics from the scoreboard, PlaceholderAPI placeholders and other plugins in a web page!**

## Features
– **Multiple sources:** WebStats can combine statistics from these sources:
– **Scoreboard** objectives
– **Placeholders** (requires [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/))
– **MySQL database:** with a customisable configuration, you can gather statistics from any plugin
– **Discord integration:** You can add WebStats as a webhook to your Discord server.
– **SkinsRestorer integration:** When present, WebStats will display player heads from SkinsRestorer (also for offline-mode and bedrock players).
– **Player head display:** The plugin uses the service provided by mc-heads.net to automatically display player heads next to the names.
– **Objective sorting:** Click on the column headers to sort on that objective. Clicking again reverses the sort.
– **Automatic data updates:** By default, WebStats refreshes the data every 10 seconds, though this is configurable and can also be disabled.
– **Online / AFK status:** When [EssentialsX](https://modrinth.com/plugin/essentialsx) is present, WebStats uses it to mark AFK players. Otherwise, you will still be able to see who is online.
– **Online player filter:** You can filter to only display online players for if you have many players.
– **Pagination:** For webpage performance, max 100 players are displayed by default with next/previous page controls.
– **Objective filtering:** In the config file, you can filter which scoreboard objectives should be visible on the webpage. By default, the filter only contains `’*’`, which means all objectives.
– **Custom column order:** By default, columns are displayed in alphabetical order. You can set your own order and select which columns should be shown.
– **Statistics export:** Save the statistics in a `.csv` file so you can make nice graphs.

## Installation
There are two ways to use WebStats: with your own server (more customisable) or with an integrated server (easier). The download contains the plugin jar plus a javascript file, you only need the javascript file for when you are using your own webserver.

For both methods, you need to open a port on the Minecraft server for the plugin to communicate over. Make sure to change the port number in config.yml (and in the web client initialisation when using your own server).

### Using integrated web server
Set `serve-webpage` in the config file to `true` and restart. That’s it.

### Using own web server
Copy the Javascript file from the zip file and import it as a Javascript module. You also need to initialise WebStats when the page loads, more detailed information and an example are present [on Github](https://github.com/Dantevg/WebStats/wiki/Getting-Started#set-up-webpage-front-end).

Please refer to the [Github wiki](https://github.com/Dantevg/WebStats/wiki/Config-file) for more information about the configuration file. It also has pages with more detailed information for some features.

## More info
I have made a simple demo page with dummy data for you to try out: [demo](https://dantevg.nl/mods-plugins/WebStats/demo/)

For more in-depth information, please see the [Github wiki](https://github.com/Dantevg/WebStats/wiki).

If you need help, or for bug reports, feedback and suggestions, please open an issue on https://github.com/Dantevg/WebStats/issues, or post in the [Spigotmc forum thread](https://www.spigotmc.org/threads/web-stats.492833/).

WebShopX

We also support English—please scroll down.

## WebShopX：Web 驱动的 Minecraft 商城与交易系统


> 这不是网页模板，而是一套可运行的交易系统。
> 官方商城（B2C）+ 玩家市场（C2C）+ 拍卖行 + 订单履约 + 管理后台，一体化落地。

### 快捷导航 (可点击)

[](https://www.bilibili.com/video/BV16zdZBTEbV/)
[](https://www.bilibili.com/video/BV18eoSBaEPY/)
[](https://docs.akihito.dpdns.org/category/webshopx)
[](https://github.com/Cc-Cece/WebShopX-Issues/issues)
[](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info)

### 环境要求

– Java 17+
– Paper 1.18.2+ 或 Folia 1.19.4+
– SQLite（无需额外配置） 或 MariaDB / MySQL
– Vault（可选）
– 支持群组服
– Language：zh-CN / en-US

### 核心闭环

– 玩家网页登录与会话
– 钱包、流水、双币兑换
– 官方商品下单、发货、退款
– 玩家市场上架、购买、竞拍、结算
– 发货失败兜底（待领取命令 + 邮箱补偿）
– 后台运营与审计治理

—

## 你能得到什么

| 模块 | 已实现能力 |
|—|—|
| 官方商城 | 出售物品、回收商品、命令、药水效果、兑换码五大类型商品 |
| 动态定价 | 官方商品支持动态定价与需求热度衰减（多算法） |
| 玩家市场 | 普通上架、供货箱上架、自动补货、改价、备注、暂停/恢复/下架 |
| 拍卖模式 | 英式、荷兰式、维克里、烛台拍卖；支持竞价、反狙击延时、到期结算 |
| 履约兜底 | 自动发货失败后可 /ws claim，且支持 mailbox 补偿领取 |
| 通知体系 | 站内通知列表、未读计数、已读标记、后台全服公告 |
| 管理后台 | 商品/订单/兑换码/市场/经济参数/用户支持/管理员管理/审计日志 |

—

## 玩家端能力

– Minecraft 用户名 + 网页密码登录
– 查看钱包余额与账变流水
– 兑换码入账
– ShopCoin / GameCoin 双向兑换
– 浏览官方商城并下单
– 浏览市场与店铺，支持搜索、筛选、排序
– 市场购买与拍卖出价（按商品交易模式）
– 查看订单并在规则内申请退款
– 领取待发货内容

—

## 玩家市场与拍卖

### 交易模式

| **模式** | **核心说明** | **适用场景** |
| ———————- | ———————————————————— | ——————————– |
| **直接购买 (DIRECT)** | 卖家设定固定价格，买家支付后立即成交。支持库存自动补货。 | 常规材料、消耗品、量产装备。 |
| **拍卖模式 (AUCTION)** | 卖家设定起拍价，在规定时间内由买家竞价，最终根据算法决定归属。 | 极品武器、稀有收藏品、地皮转让。 |

### 拍卖算法

| **算法标识** | **简称** | **逻辑简述** | **特点** |
| ———— | ————– | ———————————————————— | ——————————– |
| `ENGLISH` | **英式拍卖** | 价格由低往高喊，出价最高者获胜。支持反狙击延时（有人最后出价则自动延长）。 | 最符合直觉，互动性最强。 |
| `DUTCH` | **荷兰式拍卖** | 价格由高往低随时间自动下降，第一个确认购买的买家即成交。 | 速度快，适合想快速出手的卖家。 |
| `VICKREY` | **维克里拍卖** | 密封投标（互相看不到出价），最高出价者获胜，但支付的是**第二高**的价格。 | 鼓励买家出示心中真实的最高价。 |
| `CANDLE` | **蜡烛拍卖** | 英式拍卖的变种，拍卖结束时间在最后阶段随机。 | 防止玩家在最后一秒恶意压秒出价。 |

### 市场特性

– 供货箱库存自动补货
– 市场广播
– 周期性市场结算任务
– 卖家成交日志查询

—

## 官方商城能力

– 商品类型：

| **类型标识** | **中文名称** | **功能描述** |
| ———————– | ————— | —————————————— |
| **`COMMAND`** | **指令执行** | 购买后由控制台或以玩家身份执行预设指令。 |
| **`GIVE_ITEM`** | **物品发放** | 系统直接生成物理道具并放入玩家背包。 |
| **`POTION_EFFECT`** | **药水效果** | 购买后为玩家施加特定的 药水效果。 |
| **`RECYCLE_ITEM`** | **回收/兑换** | 系统以特定价格回收玩家特定物品。 |
| **`GROUP_BUY_VOUCHER`** | **团购/兑换码** | 交付特定的序列号或兑换凭证，支持群体核销。 |
– 商品支持发布/下架时间窗
– 可配置库存、个人限购
– 回收与实物商品可启用动态定价

—

## 履约、退款与兜底

– 订单状态覆盖 **订单挂起**、**待领**、**完成**到**退款** 等流程
– 支持订单**冷静期**与**退款**策略配置
– 可选开启未发放前可退款
– 团购券支持核销状态管理与退款联动
– 自动发货失败时可通过命令领取或邮箱补偿

—

## 管理后台

– 管理员鉴权与会话
– 商品管理、上下架、限购重置
– 兑换码创建与列表
– 团购券核销
– 订单查询
– 经济参数管理（汇率、市场税费/手续费）
– 市场管理与强制下架
– 用户支持：查用户、重置密码、解绑、强制下线、钱包调整
– 全服系统公告
– 管理员账号与权限模板管理
– 审计日志查询

### 内置角色模板

| **角色标识** | **中文名称** | **核心职能定位** |
| —————— | ————– | ———————————————————— |
| `SUPER_ADMIN` | **超级管理员** | 拥有系统最高权限，可管理所有后台模块、配置参数及管理员账号。 |
| `SHOP_ADMIN` | **商城管理员** | 负责官方商城（B2C）的运营，包括商品上下架、限购设置、兑换码生成等。 |
| `MARKET_MODERATOR` | **市场监管员** | 负责玩家市场（C2C）的治理，有权强制下架违规商品或监控拍卖行为。 |
| `SUPPORT_ADMIN` | **客服管理员** | 负责用户支持工作，如查询玩家信息、重置密码、手动调整钱包余额等。 |
| `AUDITOR` | **审计员** | 仅拥有查看和导出权限，负责审计全局日志、交易流水及管理员操作记录。 |

—

## 命令（游戏内）

| 命令 | 说明 |
|—|—|
| /webshopx help | 帮助 |
| /webshopx password <新密码> | 设置/重置网页登录密码 |
| /webshopx market [gui] | 打开市场 GUI |
| /webshopx market sell [amount] [currency] | 兼容式快速上架 |
| /webshopx market logs [count] | 查看卖家近期成交日志 |
| /webshopx claim [all|ODR-…|MKT-…|CLM-…|MCL-…] | 领取待发货内容 |
| /webshopx mailbox claim | 领取邮箱待补偿物品 |
| /webshopx redeem create [max] [perUserMax] [minutes] [code] | 创建兑换码（管理员） |
| /webshopx reload | 重载配置与网页资源（管理员） |

别名：/ws

—

## 快速开始

请前往 [Wiki](https://docs.akihito.dpdns.org/category/webshopx) 查看文字教程，或点击查看 [视频教程](https://www.bilibili.com/video/BV18eoSBaEPY/) 。

—

## 反馈与支持

– 视频介绍：https://www.bilibili.com/video/BV16zdZBTEbV/
– 配置教程：https://www.bilibili.com/video/BV18eoSBaEPY/
– Wiki：https://github.com/Cc-Cece/WebShopX-Issues/wiki
– Issues：https://github.com/Cc-Cece/WebShopX-Issues/issues
– 公测交流群（QQ）：[636803372](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info)

WebShopX 正在持续迭代，欢迎提出功能建议与真实运营场景反馈。

—

## WebShopX: Web-Driven Minecraft Store & Trading System


> This is not a web template, but a fully functional trading system.
> Official Store (B2C) + Player Market (C2C) + Auction House + Order Fulfillment + Admin Dashboard, all in one.

### Quick Navigation (Clickable)

[](https://www.bilibili.com/video/BV16zdZBTEbV/)
[](https://www.bilibili.com/video/BV18eoSBaEPY/)
[](https://docs.akihito.dpdns.org/category/webshopx)
[](https://github.com/Cc-Cece/WebShopX-Issues/issues)
[](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info)

### Requirements

– Java 21
– Paper 1.20.6+ (Spigot compatible)
– MariaDB / MySQL
– Vault (Optional)
– BungeeCord/Velocity proxy support
– Built-in languages: zh-CN / en-US

### Core Loop

– Player web login & session management
– Wallet, transaction history, dual-currency exchange
– Official store ordering, delivery, and refunds
– Player market listing, purchasing, bidding, and settlement
– Delivery failure fallback (claim command + mailbox compensation)
– Backend operations and audit governance

—

## What You Get

| Module | Implemented Capabilities |
|—|—|
| Official Store | 5 commodity types: Sell items, Recycle items, Commands, Potion effects, Redeem codes |
| Dynamic Pricing | Official products support dynamic pricing and demand decay (multiple algorithms) |
| Player Market | Standard listing, Shulker box listing, Auto-restock, Price editing, Notes, Pause/Resume/Unlist |
| Auction Mode | English, Dutch, Vickrey, Candle auctions; supports bidding, anti-sniper delay, expiry settlement |
| Fulfillment Fallback | Auto-delivery failure allows `/ws claim`, and supports mailbox compensation claim |
| Notification System | In-site notification list, Unread count, Mark as read, Global backend announcements |
| Admin Dashboard | Products / Orders / Redeem codes / Market / Economy params / User support / Admin management / Audit logs |

—

## Player Features

– Minecraft Username + Web Password login
– View wallet balance and transaction history
– Redeem codes
– ShopCoin / GameCoin bidirectional exchange
– Browse official store and place orders
– Browse market and shops, supports searching, filtering, and sorting
– Market purchasing and auction bidding (based on trading mode)
– View orders and apply for refunds within rules
– Claim pending deliveries

—

## Player Market & Auctions

### Trading Modes

| **Mode** | **Core Description** | **Use Case** |
| ———————- | ———————————————————— | ——————————– |
| **Direct Purchase (DIRECT)** | Seller sets a fixed price, buyer pays and receives it instantly. Supports auto-restock. | Common materials, consumables, mass-produced gear. |
| **Auction Mode (AUCTION)** | Seller sets a starting price, buyers bid within a time limit, algorithm decides winner. | Top-tier weapons, rare collectibles, plot transfers. |

### Auction Algorithms

| **Algorithm ID** | **Abbreviation** | **Logic Overview** | **Characteristics** |
| ———— | ————– | ———————————————————— | ——————————– |
| `ENGLISH` | **English Auction** | Price goes up, highest bidder wins. Supports anti-sniper delay. | Most intuitive, highly interactive. |
| `DUTCH` | **Dutch Auction** | Price drops automatically over time, first buyer to confirm wins. | Fast-paced, suitable for quick sales. |
| `VICKREY` | **Vickrey Auction** | Sealed-bid (blind), highest bidder wins but pays the **second-highest** price. | Encourages buyers to bid their true maximum value. |
| `CANDLE` | **Candle Auction** | Variation of English auction, end time is randomized in the final stage. | Prevents malicious last-second sniping. |

### Market Features

– Shulker box inventory auto-restock
– Market broadcasts
– Periodic market settlement tasks
– Seller transaction log queries

—

## Official Store Features

– Product Types:

| **Type ID** | **Name** | **Functional Description** |
| ———————– | ————— | —————————————— |
| **`COMMAND`** | **Command Execution** | Executes a preset command via console or player after purchase. |
| **`GIVE_ITEM`** | **Item Delivery** | System generates physical items and puts them in player’s inventory. |
| **`POTION_EFFECT`** | **Potion Effect** | Applies specific potion effects to the player after purchase. |
| **`RECYCLE_ITEM`** | **Recycle/Exchange** | System recycles specific player items at a set price. |
| **`GROUP_BUY_VOUCHER`** | **Group Buy/Voucher**| Delivers specific serials or vouchers, supports group verification. |
– Products support publish/unlist time windows
– Configurable stock and personal purchase limits
– Recycle and physical items can enable dynamic pricing

—

## Fulfillment, Refunds & Fallbacks

– Order status covers **Pending**, **To Claim**, **Completed**, and **Refunded**
– Supports order **Cool-down Period** and **Refund** policy configuration
– Optional toggle for refunds before delivery
– Group buy vouchers support verification status management linked with refunds
– Auto-delivery failure can be claimed via command or mailbox compensation

—

## Admin Dashboard

– Admin authentication & session management
– Product management, listing/unlisting, limit resets
– Redeem code creation and list
– Group buy voucher verification
– Order queries
– Economy parameter management (Exchange rates, Market taxes/fees)
– Market management and forced unlisting
– User support: Query users, reset passwords, unbind, kick offline, adjust wallets
– Global system announcements
– Admin accounts & permission template management
– Audit log queries

### Built-in Role Templates

| **Role ID** | **Name** | **Core Functionality** |
| —————— | ————– | ———————————————————— |
| `SUPER_ADMIN` | **Super Admin** | Highest system authority, manages all modules, configs, and admin accounts. |
| `SHOP_ADMIN` | **Store Admin** | Manages official store (B2C) operations, including products, limits, and codes. |
| `MARKET_MODERATOR` | **Market Mod** | Manages player market (C2C), can force-unlist items or monitor auctions. |
| `SUPPORT_ADMIN` | **Support Admin** | Handles user support, user queries, password resets, and manual wallet adjustments. |
| `AUDITOR` | **Auditor** | View and export permissions only, audits global logs, transactions, and admin actions. |

—

## Commands (In-Game)

| Command | Description |
|—|—|
| /webshopx help | Help menu |
| /webshopx password | Set/Reset web login password |
| /webshopx market [gui] | Open market GUI |
| /webshopx market sell [amount] [currency] | Compatible quick listing |
| /webshopx market logs [count] | View seller’s recent transaction logs |
| /webshopx claim [all|ODR-…|MKT-…|CLM-…|MCL-…] | Claim pending deliveries |
| /webshopx mailbox claim | Claim mailbox compensation items |
| /webshopx redeem create [max] [perUserMax] [minutes] [code] | Create redeem code (Admin) |
| /webshopx reload | Reload config and web resources (Admin) |

Alias: /ws

—

## Quick Start

Please check the [Wiki](https://docs.akihito.dpdns.org/category/webshopx) for written tutorials, or click to watch the [Video Tutorial](https://www.bilibili.com/video/BV18eoSBaEPY/).

—

## Feedback & Support

– Video Intro: https://www.bilibili.com/video/BV16zdZBTEbV/
– Setup Tutorial: https://www.bilibili.com/video/BV18eoSBaEPY/
– Wiki: https://docs.akihito.dpdns.org/
– Issues: https://github.com/Cc-Cece/WebShopX-Issues/issues
– Open Beta Group (QQ): [636803372](https://qun.qq.com/universal-share/share?ac=1&authKey=EMHvFOsEqOBnEQi%2FJZtN%2BFwamTisdy0A02IwhRsxJG8t9GWK4uKs2G4CgZpT3yHW&busi_data=eyJncm91cENvZGUiOiI2MzY4MDMzNzIiLCJ0b2tlbiI6ImlpV3lHR3BFT3NvdWxUYysrSnFBN3lSWGRGU1BlTmF4a3FJSnNXeFBNZkI0emZRVDUxdCszbzdEc1NzUlNDTS8iLCJ1aW4iOiI5NTg2MzAxNDYifQ%3D%3D&data=8nepSQv0_dZIm_ZCWW-lPMXP8xlcFXyNWUolkq1DvckJaLbB0JYLVwmuOfmH0Z7mKXGgRx6yhwpi9bjWCvi66Q&svctype=4&tempid=h5_group_info)

WebShopX is continuously iterating. Feature suggestions and real-world operational feedback are welcome.