BetaKey - advanced beta access system v4.0-RELEASE Update

BetaKey 4.0-RELEASE

What's New

Built-in Website

BetaKey now comes with its own redeem website. It runs directly inside the plugin, so you don't need a webserver, PHP or an extra database anymore.

• Enable it with /betakey website enable (port 8080 by default).
• Configure it in plugins/BetaKey/website/settings.yml.
• Guide: https://inconnu-plugins.de/wiki/betakey/website

Web Admin Panel

Manage your keys on <website>/admin:

• Statistics (total, used, unused keys)
• See who uses which key
• Search keys and players
• Create keys (up to 100 random keys at once, or custom keys)
• Delete keys

Admins log in with a password, a confirmation ingame or both (AdminPanel.Authentication). Set your password with /betakey website password <password> and confirm logins with /betakey verify <code>. Passwords are stored salted and hashed.

Website Themes and Languages

Change the design of the website with your own themes (templates and CSS). English and German are included, and the language of the visitor's browser is chosen automatically.

SQLite Support

BetaKey now works without a database server. SQLite is the new default and stores the keys in plugins/BetaKey/database/BetaKey.db.

MySQL, MariaDB and PostgreSQL are still supported, for example if several servers need the same keys.

Messages in Every Player's Language

• All messages moved to the messages folder (en-us.yml, de-de.yml).
• With Language: auto every player gets the language of their Minecraft client, and the Discord bot answers in the language of the Discord user.
• Add your own language by copying a file, e.g. to fr-fr.yml. Missing messages are taken from English.

Switch Features On and Off with Commands

Command	Effect
/betakey enable / /betakey disable	Switches the beta access (players without a key can join while it is disabled)
/betakey website enable / disable	Starts and stops the website
/betakey discord enable / disable	Starts and stops the Discord bot

The changes are saved in the config.yml and work right away, without a restart.

Clickable Help

/betakey and /betakey website now show all commands with a description. Click a command in the chat to use it.

Automatic Config Update

Your old config.yml is updated to the new format automatically. All settings and your own messages are kept.

Better Support Information

/betakey debug now also shows the website status and its last errors. It contains no passwords, so you can safely send it to the support.

Commented config.yml

The config.yml now explains every setting, including an easy database setup.

Fixes

• Security: Database queries on BungeeCord and Velocity now use prepared statements.
• Security: A Discord link can now only be confirmed for the Discord user who started it.
• A second Discord link request no longer fails after the first one.
• /unlink on Discord without a linked account no longer fails.
• /link from the console no longer causes an error.
• "Already linked" is now detected correctly when linking a Discord account.
• /betakey reload now really reloads the config.yml on Spigot.
• The "config outdated" warning no longer shows up on every start on Spigot.
• Spigot no longer prints /betasystem after every command.
• Random keys are now always 6 digits long.
• MariaDB, SQLite and PostgreSQL connections now load their database driver correctly.
• The Discord bot is now stopped when the plugin is disabled, so no second bot runs after a reload.
• An invalid Discord bot token no longer prevents the plugin from starting.
• The update check no longer runs on the main thread on Spigot.
• The copy button in the key list now copies the key on Minecraft 1.15 and newer.
• Discord links are now made with the exact player name.

Changes

• New default database: SQLite (existing MySQL configurations keep working).
• Messages moved from the config.yml to the messages folder.
• Config version updated to 3.
• The config.yml is no longer rewritten by the plugin on Spigot, so your comments are kept.
• Discord embed colors can now also be written as HEX, e.g. 0x00FF00.
• Spigot, BungeeCord and Velocity now share the same code, so all platforms get the same features and fixes.
• Tested with Paper up to 26.3.
• The PHP website is now called Legacy Website. It still works with MySQL/MariaDB, but gets no new features. Use it only if your host gives you just one port: https://inconnu-plugins.de/wiki/betakey/legacy-website

Requirements

Platform	Version	Java
Spigot / Paper	1.8.8 or newer	8 or newer
BungeeCord	current	8 or newer
Velocity	3.x	21 or newer

Minecraft 1.7 is not supported (as before).

Upgrade Instructions (Important)

1. Download and replace the old plugin .jar with the new version. Use the jar for your platform:
   • BetaKeySpigot-4.0-RELEASE.jar
   • BetaKeyBungee-4.0-RELEASE.jar
   • BetaKeyVelocity-4.0-RELEASE.jar
2. Start the server. Your config is updated automatically:
   1. The old config is saved as config.yml.v<old version>.backup.
   2. The new config.yml keeps all your settings.
   3. Your messages are moved to messages/legacy-mig.yml and Language is set to legacy-mig, so your server keeps its own texts.
3. If you want to use the new translated messages, set Language: auto in the config.yml and run /betakey reload.
4. If you used SQLite before, your database is copied to database/BetaKey.db automatically. If you use MySQL, nothing changes.
5. Optional: enable the new website with /betakey website enable and set your admin panel password with /betakey website password <password>.

---

Upgrade now and enjoy the new website, the admin panel and BetaKey in your players' language! 🎉

BetaKey - advanced beta access system v3.4-RELEASE Update

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/updates

---

✨ What's New

• Improved Console Command Support
Commands now work consistently from the console on Spigot, BungeeCord, and Velocity.

• Paper Server Compatibility Fixed
Resolved issues with the PlayerLogin event on Paper-based servers.

• Custom Discord Embed Colors
You can now change the embed color used by the Discord bot.
The value in the config must be a decimal number.
If you have a HEX color, convert it first:
https://convertingcolors.com/hex-color-FF8080.html

• Config Versioning Added
A version number in the config now allows updates to notify users if changes are needed.
No configs are auto-overwritten.

---

🔧 Fixes

• Console commands now behave correctly on all supported platforms.
• Fixed login event handling on Paper to ensure correct beta key validation.

---

🔄 Changes

• Updated BungeeCord API → 1.21-R0.4
• Updated Java Discord API (JDA) → 6.1.1
• Added Gson as an independent dependency to prevent conflicts.

---

📦 Upgrade Instructions (Important)

1. Replace your old plugin .jar with the new version.
2. Message formatting remains the same, no need to redo your text.
3. Generate a new Config.
4. If you don’t want to use custom embed colors, add this under DebugMode:

ConfigVersion = 1

2. If you want to use new Embed Color Feature, please delete the old config.yml, reboot your sever to generate a new Config.
3. If you do want custom embed colors, convert HEX → decimal and update the config.

---

Enjoy a more stable and customizable BetaKey experience! 🎉

BetaKey - advanced beta access system v3.3-RELEASE Update Latest

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/updates

What's New:

• Native Velocity Support:

  • BetaKeySystem is now fully compatible with Velocity!

• New Database Management System (DBMS) Support (Experimental!):

  • Now supports MariaDB, SQLite, and PostgreSQL (⚠️ Only MySQL is fully supported! MariaDB has been lightly tested, while SQLite and PostgreSQL remain untested—please report any issues on Discord).

• Command Enhancements:

  • Added command tab completion for easier use.
  • New command /betakey debug for debugging and error tracing.

Fixes:

• Removed inaccurate Discord reachability check.

• Improved SQL Error Handling:

  • Fixed SQL-Driver not found issue.
  • Database connection errors are now tracked and logged properly.

• Major Fix: SQL Connection Handling on Player Join!

  • Fixed an issue where players could join when the database connection was broken.
  • Now, if the connection fails, the system will attempt automatic reconnection.
  • If reconnection still fails, the player will be kicked to prevent unauthorized access (ensuring beta key verification is always enforced).

• Fixed key-copy button in BungeeCord version.

Changes:

• New Update Notifier:
  • Snapshots are now detected as such.
  • Customizable update messages in logs and in-game (for admins).

Upgrade Instructions:

1. Download and replace the old plugin version with the new one.
2. If using BungeeCord or Velocity, delete the old configuration to ensure compatibility.
3. Your message layout remains unchanged, so no need to update existing messages.

Upgrade now and enhance your BetaKeySystem experience! 🚀

BetaKey - advanced beta access system v3.2-RELEASE Update

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/updates

Description:
Unlocking New Features and Enhancements!

---

What's New:

• Update Commands:
• Added /betakey list all/used/unused command.
• Added copy button on key creation.

---

Upgrade Instructions:

1. Download the new plugin.
2. Replace the old version with the new one.
3. If issues arise, especially on BungeeCord systems, delete the old configuration to set up the new one.
4. The message layout remains the same, so you can seamlessly transition with your existing messages.

Upgrade now and elevate your BetaKeySystem experience!

BetaKey - advanced beta access system v3.1-RELEASE Update

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/updates

Description:
Unlocking New Features and Enhancements!

---

What's New:

• Update Discord Bot Integration:
  • Added custom status type (ONLINE, IDLE, DO_NOT_DISTURB and INVISIBLE).
  • Added custom activity (PLAYING, LISTENING, WATCHING).

---

Fixes:

• Minor bug fixes for a smoother experience.
• No more errors if the database isn't configured yet.

---

Changes:

• Adjustments in config.yml for Debug mode and Discord Bot.

---

Upgrade Instructions:

1. Download the new plugin.
2. Replace the old version with the new one.
3. If issues arise, especially on BungeeCord systems, delete the old configuration to set up the new one.
4. The message layout remains the same, so you can seamlessly transition with your existing messages.

Upgrade now and elevate your BetaKeySystem experience!

---

Beschreibung:
Neue Funktionen und Verbesserungen!

---

Was ist neu:

• Update Discord Bot Integration:
  • Added custom status type (ONLINE, IDLE, DO_NOT_DISTURB and INVISIBLE).
  • Added custom activity (PLAYING, LISTENING, WATCHING).

---

Upgrade-Anleitung:

1. Lade das neue Plugin herunter.
2. Ersetze die alte Version durch die neue.
3. Lösche bei Problemen, besonders auf BungeeCord-Systemen, die alte Konfiguration, um die neue zu generieren.
4. Das Nachrichtenlayout bleibt unverändert, sodass du nahtlos mit deinen vorhandenen Nachrichten wechseln kannst.

Upgrade jetzt und erlebe dein BetaKeySystem auf einer neuen Ebene!

BetaKey - advanced beta access system v3.0-RELEASE Update

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/updates

Description:
Unlocking New Features and Enhancements!

---

What's New:

• Introducing Discord Bot Integration:

  • Create beta keys with /create command.
  • Redeem keys using /redeem.
  • Delete keys via the /delete command.
  • Link your Minecraft account to gain special roles with /link.
  • Unlink your account with /unlink.

• Stay Updated:

  • Receive update reminders when the plugin needs an upgrade.

• Debug Your Way:

  • Activate Debug mode for detailed error traces.

---

Fixes:

• Minor bug fixes for a smoother experience.
• No more errors if the database isn't configured yet.

---

Changes:

• Adjustments in config.yml for Debug mode and Discord Bot.

---

Upgrade Instructions:

1. Download the new plugin.
2. Replace the old version with the new one.
3. If issues arise, especially on BungeeCord systems, delete the old configuration to set up the new one.
4. The message layout remains the same, so you can seamlessly transition with your existing messages.

Upgrade now and elevate your BetaKeySystem experience!

---

Beschreibung:
Neue Funktionen und Verbesserungen!

---

Was ist neu:

• Vorstellung der Discord Bot Integration:

  • Erstelle Beta-Keys mit dem Befehl /create.
  • Löse Keys mit /redeem ein.
  • Lösche Keys über den Befehl /delete.
  • Verknüpfe deinen Minecraft-Account, um spezielle Rollen mit /link zu erhalten.
  • Entlinke deinen Account mit /unlink.

• Bleib auf dem Laufenden:

  • Erhalte Erinnerungen zur Aktualisierung, wenn das Plugin ein Upgrade benötigt.

• Debuggen nach Maß:

  • Aktiviere den Debug-Modus für detaillierte Fehlerverfolgung.

---

Fehlerbehebungen:

• Kleinere Bugfixes für eine reibungslosere Erfahrung.
• Keine Fehler mehr, wenn die Datenbank noch nicht konfiguriert ist.

---

Änderungen:

• Anpassungen in der config.yml für den Debug-Modus und den Discord Bot.

---

Upgrade-Anleitung:

1. Lade das neue Plugin herunter.
2. Ersetze die alte Version durch die neue.
3. Lösche bei Problemen, besonders auf BungeeCord-Systemen, die alte Konfiguration, um die neue zu generieren.
4. Das Nachrichtenlayout bleibt unverändert, sodass du nahtlos mit deinen vorhandenen Nachrichten wechseln kannst.

Upgrade jetzt und erlebe dein BetaKeySystem auf einer neuen Ebene!

BetaKey - advanced beta access system v2.0 Update

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/

• Added source code.
• Added developer API.

API:
Create a key:
Code:

BetaKeyAPI.createKey.("key");

Delete a key:
Code:

BetaKeyAPI.deleteKey.("key");

Check if a key already exists:
Code:

if (BetaKeyAPI.keyAlreadyExists.("key")){
  // Do stuff if key exists
}

Deutsch:​

• Added source code.
• Added developer API.

API:
Erstelle einen Key:
Code:

BetaKeyAPI.createKey.("key");

Lösche einen Key:
Code:

BetaKeyAPI.deleteKey.("key");

Schau, ob ein Key schon existiert:
Code:

if (BetaKeyAPI.keyAlreadyExists.("key")){
  // Do stuff if key exists
}

BetaKey - advanced beta access system v1.0

https://builtbybit.com/resources/betakey-advanced-beta-access-system.18428/