PRISMARIN 1.1.0

New in 1.1.0

• Clans. /clan create <name> <tag>, the tag &7[&f%name%&7] next to the name in chat and tab list, a colour per clan, four roles with their own colours, clan chat with /cc, /clan info grouped by role. The clan shows up in friend lists, party lists, /pinfo and the lobby menus. Full API with cancellable events for clan wars and rankings.
• Stats and leaderboards. Network wide stats with weekly and monthly periods, /stats [player] [game] [page], floating leaderboards in the lobby with /leaderboard create. Stats of other plugins show up too: pushed through the API, read from a pull source for plugins with their own database, or taken from a PlaceholderAPI placeholder set in stats.yml.
• Daily rewards. /daily with a login streak, rewards per day and milestones in any currency, an entry in the lobby profile.
• Vote rewards. Votes through NuVotifier on the proxy (optional), /vote with the site links, streaks, and rewards that wait for players who are offline.
• Server queue. Full servers and groups queue players instead of refusing them, with the place in the action bar. Priorities by permission, parties wait as one unit, staff can pause, clear and push queues.
• JoinMe. /joinme sends a clickable invite with the creator's skin face drawn in chat to the lobbies. Game plugins decide through the API where a joining player lands; without an integration it is the same server and world. /joinme preview shows your own JoinMe to you only.
• Cosmetics. 81 cosmetics: 20 hats, 13 auras, trails, 15 arrow trails, 16 kill effects and 10 win effects, bought with the network's currencies from a hotbar chest or /cosmetics. Arrow trails and kill effects work on game servers without any integration, win effects through /cosmetics play <player> win-effect in the win commands of your game plugin. Effects never change the game.
• Chat filter and alt accounts. Words, capital letters, links, repeats and spam on every server, repeated hits run a punishment template. /alts lists accounts that share an address, stored only as salted hashes.
• Admin. /prismarin reload and /prismarinproxy reload, an update check that tells staff about new releases, anonymous bStats metrics.

Smaller changes

• Profile menu: the rank is shown by default, so both rows line up. Rows with six or eight entries stay symmetric.
• Navigator with coloured player counts and descriptions.
• /lobbybuild (now also /build) puts the lobby items away and gives them back afterwards.
• Fewer decorative symbols in command replies, for example in /coins.

Updating from 1.0.x

Replace all three jars at once and restart, proxy and backends need the same version. New features are switched on by default and write their own files on first start: stats.yml, daily-rewards.yml, votes.yml, queue.yml, joinme.yml, cosmetics.yml, chat-filter.yml and alts.yml, plus a clans section in social.yml. Each one can be switched off under modules in config.yml. Untouched language files update themselves.

Downloads

PRISMARIN-1.1.0.zip holds everything with a short install guide. The single jars are attached as well:

File	Goes on
PrismarinCore.jar	every Paper backend
PrismarinLobby.jar	lobby servers, next to PrismarinCore
PrismarinVelocity.jar	the Velocity proxy

Compatibility: Paper 1.21.7 to 1.21.11, Velocity 3.4, Java 21.

API

compileOnly("com.github.LeonManuel0705:prismarin:v1.1.0")

Checksums (SHA-256)

2b2f97010dc87e55020755a789f6eb8d8c0a90308663ded80d50ddec3d804eff  paper/PrismarinCore.jar
c44b7fdd03c951e7b667990e14897c3fcc0f4cfe726249d91463af3eea00c1e6  paper/PrismarinLobby.jar
0cdad178edfb0110e819639f8f165ed2b4c70d3cc3a405d45b11d357b3291f1d  velocity/PrismarinVelocity.jar
73f9e94773d195a6af1bcffbb3dff6e55fa827688d2fc2c95e4e03c8a58dd59f  PRISMARIN-1.1.0.zip

PRISMARIN 1.0.4

Changes since 1.0.3

• Much smaller jars. All three jars together drop from 31 to 4 MB: PrismarinCore 0.9 MB, PrismarinLobby 0.2 MB, PrismarinVelocity 3 MB.
• Libraries on demand. PRISMARIN downloads what your configuration uses from Maven Central on first start and checks every file. Paper loads Guice, Configurate and the drivers through libraries: in plugin.yml. The proxy fetches the SQLite or MongoDB driver only for that storage.mode and the Redis client only with redis.enabled, relocated so it never clashes with Velocity's own Netty. MYSQL and MARIADB without Redis download nothing. Without internet, copy the jars into plugins/prismarin-core/libraries/. A mirror can be set with -Dprismarin.libraryRepository=<url>.
• Guava and SnakeYAML come from Paper itself.

Downloads

PRISMARIN-1.0.4.zip holds everything with a short install guide. The single jars are attached as well:

File	Goes on
PrismarinCore.jar	every Paper backend
PrismarinLobby.jar	lobby servers, next to PrismarinCore
PrismarinVelocity.jar	the Velocity proxy

Compatibility: Paper 1.21.7 to 1.21.11, Velocity 3.4, Java 21.

API

compileOnly("com.github.LeonManuel0705:prismarin:v1.0.4")

Checksums (SHA-256)

a0b1dcb51370a15b83269f852e9550dd92424f311cadc5d0a16be3d2fa94cbf7  paper/PrismarinCore.jar
6aaaecd94a4fe3cf5a4c80589e9cc2eee21a866ccdb9cb4ab3a403c0625a7c73  paper/PrismarinLobby.jar
ec2537cdd9c4422369d28555702059bd0fe0b37c8db95e2c33e9518f7300c0a5  velocity/PrismarinVelocity.jar
e9f8e1992a4dbddf9906489da0e7cadb65a8794805369b5f24de9e77561fd3a4  PRISMARIN-1.0.4.zip

PRISMARIN 1.0.3

Changes since 1.0.2

• Rank display. rank-display in config.yml has one line for the rank in front of a name (tab list, name tag, chat) and one for the rank on its own (sidebar, profile, %prismarin_rank_label%). %rank% is the LuckPerms meta rank-label or the prefix with its trailing separator cut off, so a prefix like &cAdmin &8┃ reads Admin in the sidebar while the tab list keeps the separator. Fake ranks of nicked players go through the same lines.
• Command feedback in colour. Confirmations are light green, problems light red, instead of check marks and crosses. Set them in branding.success-prefix and branding.error-prefix, use %success_prefix% and %error_prefix% in your own texts.
• New graphics for the plugin pages.

Downloads

PRISMARIN-1.0.3.zip holds everything with a short install guide. The single jars are attached as well:

File	Goes on
PrismarinCore.jar	every Paper backend
PrismarinLobby.jar	lobby servers, next to PrismarinCore
PrismarinVelocity.jar	the Velocity proxy

Replace the jars and restart. Configs and untouched language files update themselves.

Compatibility: Paper 1.21.7 to 1.21.11, Velocity 3.4, Java 21.

API

compileOnly("com.github.LeonManuel0705:prismarin:v1.0.3")

Checksums (SHA-256)

e420372a3581fb4742a1010d6192e3170f77badb3791228c84c0c2e0ecc677d9  paper/PrismarinCore.jar
2cf711933ff63020e8644d2c7effd168403020bbb08d9cf28a6f9a9d715cc618  paper/PrismarinLobby.jar
f0f535304883a7c19ff6898f2b517778ee3b607c4bb1a9d90ef5f74b99af0f41  velocity/PrismarinVelocity.jar
8e8e510d3caf56f0b40660c106c560f29c07234c285198bb357b01bb77cd4f1c  PRISMARIN-1.0.3.zip

PRISMARIN 1.0.0

The first stable release of PRISMARIN, a framework for Minecraft networks on Paper and Velocity.

Downloads

File	Goes on
PrismarinCore.jar	every Paper backend
PrismarinLobby.jar	lobby servers, next to PrismarinCore
PrismarinVelocity.jar	the Velocity proxy

Every server writes its config.yml on first start. For a network with more than one backend set storage.mode to MYSQL, MARIADB or MONGO on all servers and set redis.enabled: true, so profiles, balances, nicks and reports are shared. A single test server runs out of the box with LOCAL or SQLITE.

Compatibility

Part	Supported
Backends	Paper 1.21.7 to 1.21.11 and forks based on it, tested live on 1.21.11. Spigot, Bukkit and Folia are not supported.
Proxy	Velocity 3.4
Java	21 or newer
Clients	Whatever the proxy accepts. With ViaVersion, ViaBackwards and ViaRewind, 1.21 and 1.16.5 clients were tested; 1.8 clients need worlds that stay between Y 0 and 255.
Older backends	A 1.8 or 1.16 server can run behind the proxy and keeps every proxy feature (bans, mutes, reports as clickable chat, friends, parties, private messages, staff chat, maintenance). Menus, nicks, vanish and the sidebar need PRISMARIN on the backend itself.
Optional	MySQL 5.7+, MariaDB, MongoDB, SQLite, Redis or a Redis compatible server, LuckPerms, Vault or VaultUnlocked, PlaceholderAPI

Highlights

• Friends and parties with requests, online status, jump, party chat, leader and moderator roles, network wide /msg and /r
• Nicks across servers with name, skin and a fake rank, auto nick and rules per server group, round and world
• Reports with a reason menu, bundled cases, recent chat as evidence, claims, a /reports staff menu, offline targets and thanks for reporters
• Punishments with templates that escalate on repeat offences, a punish menu, ban and mute lists, history and /check
• Staff tools: SuperVanish style vanish with live inventory view, staff mode via /mod, staff chat, /network overview, /pingtest, audit log, outage alerts with Discord webhook
• Lobby with navigator, several lobbies and premium lobbies, profile and language menu, nick tool, silent lobby, player hider, double jump and custom hotbar items
• Ranks and levels with LuckPerms prefixes, suffixes, display names and chat colours, /rank, /level and a balance command per currency
• Everything configurable: every text in YAML with MiniMessage, & codes and hex colours, every system and feature switchable, German and English included, more languages by dropping in a messages_<tag>.yml

API

Every system is reachable from other plugins: players, economy, levels, vanish, staff mode, nicks, friends, parties, reports, punishment templates, storage, audit log, maintenance, notifications, sidebar, tablist, chat, menus and the lobby. The full list with events is in docs/api.md, and the example-paper module is a complete plugin built only on the API.

repositories {
    maven("https://jitpack.io")
}

dependencies {
    compileOnly("com.github.LeonManuel0705:prismarin:v1.0.0")
}

Add depend: [PrismarinCore] to your plugin.yml, then PrismarinProvider.get().

Checksums (SHA-256)

170f8de414de3c8b1b7f2140a03f7888b5554689e8f60a21503218ee25d04aea  PrismarinCore.jar
b6a6ec2734fe114a7cde3bdc4c7f9df7ccdca744f9e0c8e3d1d73e4c1b211962  PrismarinLobby.jar
52a957d8cc2c5a6bd465d8818c1cddabf2b2919009dcd99d170707edd27bfd3a  PrismarinVelocity.jar

PRISMARIN 0.4.0

The first public release of PRISMARIN, a framework for Minecraft networks on Paper and Velocity. A network installs the three jars, plugs its own game servers in behind them and gets profiles, currencies, localisation, server selection and admin tools across every server.

Requirements

• Paper 1.21.x (Purpur and other Paper forks work), Velocity 3.4
• Java 21 or newer
• Optional: MySQL, MariaDB or MongoDB for shared storage, Redis or a Redis compatible server for cross server messages, LuckPerms, Vault or VaultUnlocked, PlaceholderAPI

Installation

1. PrismarinCore.jar on every Paper server, PrismarinVelocity.jar on the proxy, PrismarinLobby.jar on lobby servers only if you want the bundled lobby.
2. Start once. Every server writes its config.yml, servers.yml and language files.
3. Give every backend a unique server-id, list your servers and groups in servers.yml.
4. For a real network set storage.mode to MYSQL or MONGO and redis.enabled to true on all servers.

What is in it

• Profiles and any number of currencies with atomic transactions on JSON, SQLite, MySQL, MariaDB or MongoDB, plus /prismarin migrate to move between them
• Branding, & colour codes, hex colours and %placeholder% texts everywhere, every system and module can be switched off
• Vault (classic and VaultUnlocked with all currencies) and PlaceholderAPI in both directions
• Game states from the API or from any game plugin's placeholder, server groups in the navigator, /play <group> and connectToGroup that pick the best free server
• /network live overview with players, ping, TPS, memory and uptime per server
• Proxy admin tools that work without Redis: staff chat and list, /find, /send, /goto, bans and mutes with durations, kicks, warnings, history, reports, broadcasts, maintenance per server or group, player records, audit log, outage alerts with Discord webhook
• Vanish in the style of SuperVanish with silent containers and silent block breaking
• Steps aside automatically when TAB, a scoreboard plugin or a chat plugin is installed

Full documentation of configuration, commands and permissions follows. Until then see README.md and ROADMAP.md.

Checksums (SHA-256)

7081a29a2e6da206f927a93286ba8e3bd73d1b6939a248da10538ab247ea7a38  PrismarinCore.jar
470cfcdd954d7ff2507a3f842ed193fb2fdfed00b6b503c3cc09957516aeb539  PrismarinLobby.jar
330f403d6c6ea80b9c20d0e0312eef25090c51c9a8729169bec0da47b8ec734e  PrismarinVelocity.jar