Release 6.608

EasyAdmin 6.608

EasyAdmin 6.608, this is a hotfix for a missing permission check, giving players the ability to use a certain (non-destructive) EasyAdmin command, we advise updating as soon as possible, this update does not include any breaking changes and is safe to update from any 6.6 version.

Changelog 6.608

• Minor fixes for Discord Bot due to bugs which occured due to the dependency bump.

Changelog 6.607

• Removed "announce" and "teleport" server commands, neither should have existed, announce will have a GUI option later on
• tweak a certain error message when the Bot could not purge the server status channel
• optimized the deferral when joining the server, servers with big banlists (>800 entries) should now see a significant speedup.
• entity cleanup has been entirely rewritten, you can now select the radius of the cleanup, also added an option to do a "Deep Clean" to remove clientside entities as well
• bumped discord.js version

Changelog 6.606

• remove chat suggestions for unsupported commands
• duplicate ban ids should now automatically be fixed by EasyAdmin
• running a bot command will now run the permission sync, you no longer need to manually run the refreshperms command.
• clarify a chat bridge error
• various harmless exceptions have been fixed

Community Pull Requests

• Don't register calladmin and report commands unless enabled. by @Troughy in #367

New Contributors

• @Troughy made their first contribution in #367

Full Changelog: 6.605...6.608

Release 6.605

EasyAdmin 6.6

Welcome to EasyAdmin 6.6, this update introduces an integrated Discord bot with a ton of new features.

From this release onwards, EasyAdmin requires the default resource yarn to be installed on the server and to be updated, you can get the latest yarn from cfx-server-data

---

Changelog

• EasyAdmin's code has been majorly restructured, you do not need to delete any files, easyadmin will take care of that itself.

• ipPrivacy convar is now enabled by default

• fixed a bug that caused EasyAdmin to complain about defaultkey being unset, despite being unused.

• update spanish translations (thanks Jen!)

• tiny improvements to menu generation

• Added Discord bot, to set it up, please see the Discord Bot docs

• • Discord ACE Permissions integration ( assign a role on Discord, get EasyAdmin permissions ingame )
• • FiveM <-> Discord chat bridge
• • ability to add/remove users from ACE groups and changing permissions directly from Discord
• • live server status display on Discord with join link.
• • a ton of commands (announce,ban,freeze,kick,mute,player list, slap....)

6.601

• removed an error message that was meant to be muted, if you use 6.6 and see a "Unknown Member" error, this can be safely ignored.

6.602

• fix Discord Bot

6.603

• Bot will now alert for various configuration mistakes
• fixed various issues in the Bot, including a race condition that caused permission checks to fail
• update djs version
• fixed some bugs related to the live server status, it will no longer use the project description, and filter out any colourcodes

6.604

• fix an issue where discord ace permissions would fail, causing the permission check to break
• fixed a bug where the chat bridge would cause the chat resource to break
• corrected a language string where an incorrect permission name was provided as an example (@zRxnx)

6.605

• added fetchBan export
• fixed a bug that caused unbans not to be logged
• you can now exclude the join/leave message using ea_excludeWebhookFeature (joinleave)
• added Log Forwarding, this is used to forwards specific logs to other channels, this accepts the same features as ea_excludeWebhookFeature
• • Usage: ea_addBotLogForwarding feature channelId
• • • ea_addBotLogForwarding joinleave 951205911991554100
• added configure command for the bot, can be used to set up log forwarding, chat bridge and live server status.
• improvements to the Bot Permission check and Discord ACE Permissions integration, fixing various bugs and minor issues.

Community Pull Requests

• Add some things for the bot by @Jaccosf in #327
• Update pl.json by @Robi321 in #328
• feat(bot): add Presence & update fxmanifest by @Jaccosf in #330
• Update README.md by @OfficialSkypo in #336
• 🐌💙💛 by @OfficialSkypo in #337

New Contributors

• @OfficialSkypo made their first contribution in #336

---

Supported by:

10% Discount Code: blumlaut-a-1757

Full Changelog: 6.5...6.604

Pre-Release 6.6p3

This is Preview 6.6p3

This is meant for testing only! please report any bugs or issues you experience, otherwise we cannot fix them!

There is currently a bug in which the Bot will trigger a Discord Ratelimit and cause a token-reset, we need help investigating this issue, if you are experiencing it please make sure to update your EasyAdmin to this release and give logs and extra infos in the Github issue #332 or on Discord!

Changelogs

• Webhook is now ignored if bot log channel is configured, all webhook messages get posted by the bot instead.

• various tweaks to the resource manifest (you MUST refresh if you update easyadmin on a live server)

• formatting tweaks

• remove webpack dependency

• rewrite easter egg system

• Update Dependencies

• Refer to 6.6p1 and 6.6p2 changelog

You can configure the bot using this guide:
https://easyadmin.readthedocs.io/en/6.6/discordbot/

Pre-Release 6.6p2

This is Preview 6.6p2

This is meant for testing only! please report any bugs or issues you experience, otherwise we cannot fix them!

There is currently a bug in which the Bot will trigger a Discord Ratelimit and cause a token-reset, we need help investigating this issue, if you are experiencing it please make sure to update your EasyAdmin to this release and give logs and extra infos in the Github issue #332 or on Discord!

Changelogs

• feat(bot): add Presence & update fxmanifest by @Jaccosf in #330

• add bot presence (also by @Jaccosf)

• Update Polish Translation (@Robi321)

• Updated Spanish Translation (Jenoxen)

• Added some extra logging to investigate #332

• moved all dependencies into a single require call, also to investigate #332

• Refer to 6.6p1 changelog

You can configure the bot using this guide:
https://easyadmin.readthedocs.io/en/6.6/discordbot/

Pre-Release 6.6p1

The first 6.6 preview has been released.

This is meant for testing only! please report any bugs or issues you experience, otherwise we cannot fix them!

Changelogs

• Added EasyAdmin Discord Bot, allows for moderating your server entirely from Discord! Includes commands like kick, ban, mute, freeze and much more! Also a live server status display, chat bridge and discord logging

Please note that the Discord bot required major Code Changes in EasyAdmin, as such, if you are experiencing issues, both inside the
EasyAdmin GUI and with the bot, please report them! Some features may be incomplete or missing

You can configure the bot using this guide:
https://easyadmin.readthedocs.io/en/6.6/discordbot/

• Added a self-check for EasyAdmin to detect a broken install
• ea_ipPrivacy is now on by default

Release 6.5

EasyAdmin 6.5

This update introduces some QOL Fixes and usability improvements.

Please make sure to read the Updating Guide for this Release.

---

Changelog

• Removed ea_defaultKey Convar, please see the Docs on how to configure the Keybind as of 6.5.
• Added new "Admin Chat", if your chat resource is up to date, you will now be able to press Tab to open it, the chat is only visible to people with easyadmin.server.chat permission.
• Chat Mutes now use the new Chat API where possible.
• Shortcuts now get parsed in the "Reason" field in the EasyAdmin GUI.
• Reasons no longer escape the Menu Borders if the text is too long, it will automatically be cut short now.
• Weither a Player is frozen or muted is now synced between Admins live, the Checkboxes will automatically check/uncheck themselves depending on what the users' current state is.
• Minor improvements to Player Caching.
• Removed legacy "version.json", EasyAdmin will automatically delete the file from your EasyAdmin folder.

Community Pull Requests

• feat(gui): more easteregg chance by @Jaccosf in #324

---

Supported by:

10% Discount Code: blumlaut-a-1757

Full Changelog: 6.43...6.5

Release 6.43

EasyAdmin 6.43

---

Changelog (6.43)

• Fix EasyAdmin:addBan being broken again.

Next time please report Bugs properly, once again, "it doesnt work" provides us absolutely no Infos, thanks to a kind soul on Discord who provided actionable Info, this was now fixed.

Changelog (6.42)

• Fixed various cases where debug messages had wrong log levels, resulting in unnecesarry clientside notifications
• (API) clientside PrintDebugMessage should no longer result in errors

Changelog (6.41)

• Fixed an error that occured when a screenshot was taken but timed out
• Fixed EasyAdmin adding duplicate lines to server.cfg and/or easyadmin_permissions.cfg if resource name contained magic characters
  If your easyadmin_permissions.cfg file is unusually large, please delete it! also make sure the bottom of your server.cfg does not have a lot of repeated lines added by EasyAdmin!
• EasyAdmin:addBan no longer has a parameter to mark it as an offline ban, this is now determined by EasyAdmin automatically, passing an array of identifiers is still valid.
• Fixed an issue where opening a player's submenu would reset your cursor position on the player list
• Streamlined data required to open EasyAdmin, high-traffic servers should experience a significant speedup in menu opening time.
• Cached Players menu now gets generated when selected, not when initially opening the menu, this should help some cases where cached players wouldn't display
• Added an error when writing banlist or backups fail, previously this would silently fail
• Errors will now also show as notifications to online admins to increase their visibility
• Fixed an issue where addBan would add the ban but fail kicking the player due to a bug in a Community PR

---

Supported by:

10% Discount Code: blumlaut-a-1757

Full Changelog: 6.402...6.43

Release 6.402

EasyAdmin 6.402

---

New Text Input

EasyAdmin 6.4 ships with a new input field, replacing the native GTA V inputfield, this new field allows for Copypasting and Mouse Controls

---

Custom Ban Times

You can now select a custom ban times when banning a player:

Pressing select here will open up the menu to define your custom time!

---

Menu Performance Improvements

EasyAdmin will now generate Player Menus once they are selected instead of all in one go, this should generally improve performance when the menu is opened and/or open.

Menus will also no longer get displayed if users dont have any permissions for them.

---

Spectator Mode Improvements

Thanks to a PR by @ixhal, leaving spectator mode will now teleport you back into your car, if you were in one before.

---

Updates to Report/Call Admin

Reporting a User or Calling for an Admin now requires a reason to be entered, apparently people never really did that before.

---

Localisation Updates

Languages which haven't been actively maintained by anyone have been removed, these are cs, pt and sv

---

eaDiag

Added (an early version of ) the eaDiag command, this will (hopefully) replace the support.json at one point, it is meant to be used if EasyAdmin is not working entirely as expected, to identify possible configuration issues.

---

Community Pull Requests

• Spanish localization update by @Antho7Twitch in #284
• DE Updated 1.0 by @zRxnx in #285
• Update pl.json by @Robi321 in #286
• DE Update by @zRxnx in #287
• feat(manifest): add presentDeferral by @Jaccosf in #288
• Add Ban ID to webhook notification for easier appeal work by @coleminer0112 in #289
• Automatically enter vehicle after ending spectate. by @ixhal in #294
• DE Update 1.0 by @zRxnx in #295
• feat(report): force reason by @Jaccosf in #297
• DE Update 1.0 by @zRxnx in #298
• PL Update 1.0 by @Robi321 in #299
• FR Update 1.0 & PL Update 1.1 by @Robi321 in #300
• Updated wiki links by @Robi321 in #301

New Contributors

• @Robi321 made their first contribution in #286
• @ixhal made their first contribution in #294

Bye

Supported by:

10% Discount Code: blumlaut-a-1757

Full Changelog: 6.34...6.402

Release 6.34

EasyAdmin 6.3

Welcome! This update is an important step in Future-Proofing EasyAdmin, lots of good stuff, read below!

As always, please read the Update Instructions

---

ea_menuButton -> ea_defaultKey

As it seems the change that was done to ea_menuButton was a bit confusing, we have now renamed it to ea_defaultKey, the behaviour stays the same, only the name changed.

- setr ea_MenuButton "F2"
+ setr ea_defaultKey "F2"

---

Ban Viewer/Editor

The player.ban permission now has 3 more permissions:

player.ban.view
player.ban.edit
player.ban.remove

Alongside that, some parts of a ban can now be edited in-game!

---

Deferrals

EasyAdmin now defers a connection while checking the banlist:

This should be both more reliable and performant on the server-side, thanks @kotzeimer

---

Reports can now be claimed

Admins can now claim reports to handle, this should help organization, the "claim" state is synced between players live!

Permission is

player.reports.claim

---

New Notifications + Plugins

EasyAdmin now uses GTA V notifications by default, if pNotify, t-notify or mythic-notify is available, those resources will be used instead. Thanks @Jaccosf for adding t-notify and mythic-notify support!

In case you want to use a different resource for EasyAdmin notifications, take a look at the example here.

---

Onesync support for RedM

EasyAdmin's RedM component now supports onesync, 's all.

---

Translations

Once again, a few new strings have been added, and existing ones modified, if you are willing to Translate these new strings and/or correct existing ones, feel free to look at them here, make a Pull Request with your changes :)
However, i would like to ask not to use translation tools as these are usually inadequate, you should speak the language you are translating fluently.

---

Various Performance Improvements and Bugfixes

once again, there has been a ton of work to make this update what it is:

• Various client/serverside performance improvements
• Enabled support for Lua 5.4
• Disk I/O improvements regarding banlist backups
• Re-add "right" menu orientation
• Refactor update check, uses latest github release to determine stable version
• search is now no longer case sensitive
• cached users are now also findable in search, but low priority
• calladmin/report commands are now enabled by default
• ban id is now shown when a player connects and is banned
• various fixes in banlist system
• use Latent Events for big EasyAdmin events, hopefully improving server-performance and net thread speed
• fix a bug that caused easyadmin to entirely break when searching for a specific ban
• EasyAdmin will now complain if its not a release but a pre-release
• screenshots triggered by resources will now show the resource name it was triggered by
• disable permission editor code if there is a hyphen in the resource name (#271)
• fix a bug when teleporting all players that caused easyadmin to claim it was an unknown player that was teleported
• Muting a player now also mutes them in voice chat (onesync only)
• added ea_printIdentifiers command, enter a player id to view all of their identifiers.
• banned xin

Merged Pull Requests:

• DE updated by @zRxnx in #243
• Added localised text in calladmin cooldown by @Javiito32 in #246
• tweak(client/spectate): optimisation by @Jaccosf in #248
• Update polish translation by @Nimplex in #251
• tweak(events): remove AddEventHandler where possible by @Jaccosf in #253
• Fix /calladmin and /report not notifying admin by @xnubil in #272
• Update and fix notification plugins by @Jaccosf in #278

Fixes in 6.31 & 6.32

• GetVersion no longer passes a Version number but a String, plugins should use tonumber()
• when viewing a ban, the values inside the ban can no longer be clicked if edit permission is missing
• Fix some cases of floating-point imprecision being a nuisance on Linux.

Fixes in 6.33

• Fix some cases where due to a race condition, addReminder, addShortcut and ea_excludeWebhookFeature produced an error
• there will now be an error if a player that is immune is attempted to be kicked/banned
• ea_printIdentifiers now uses cache
• unban command now also accepts ban id
• DE Update by @zRxnx in #280

6.34

• Updated Polish Localisation ( @kubamaz )
• Checking Banlist is now considerably faster than before
• added ea_presentDeferral Convar, set to false in case there are conflicts with the deferral and adaptive cards.
• ea_printIdentifiers should now work as expected
• Permission checks are now rate limited, a player can refresh their permissions once every 15 seconds.
• You can now teleport both yourself and other players back to their original location after teleporting.
• fix mythic-notify plugin not working correctly ( @Jaccosf )

Take care

Supported by:

10% Discount Code: blumlaut-a-1757

Full Changelog: 6.2...6.33

Release 6.2 (+Hotfix 6.202)

Welcome to EasyAdmin 6.2

UPDATE 6.2 INCLUDES BREAKING CHANGES! PERMISSIONS HAVE BEEN ENTIRELY REWORKED! PLEASE READ THE UPDATING INSTRUCTIONS

If you are only here for the Hotfix changelogs, scroll to the bottom!

And now we're here, EasyAdmin 6.2 has been officially released, this has been a very long time coming and we put a ton of work into this update, hope you enjoy!

---

Permissions Rework

All Permissions have been reworked from scratch, they are now named properly according to the category they fit in, they have also been expanded with more Permissions added and using specific permissions for specific functions.

If you are updating from <6.2 then Please read the Updating Guide, your Permissions will most likely stop working if you do not update them accordingly!

---

UI Facelift

Credit to these Logos go to Team Snaily who have been absolutely amazing in creating the new EasyAdmin logo and variations of it and have gone absolutely above and beyond for some of the things we thought up.

If you are looking for a Graphic Designer for your FiveM Server, be that for a Logo or just general design work, don't hesitate to get in touch with them, they are amazing to work with, check them out here:

As of now you can preview all the Easter Eggs in the Settings Page, although if you don't want to spoil the fun for yourself, don't worry, these pop up every now and again at random. 😉

---

Permission Editor System

This is a completely new way to edit ACE Permissions on your server, these apply live and even save to a file which gets executed automatically on server start!

Permissions:

easyadmin.server.permissions.read
easyadmin.server.permissions.write

---

Report GUI

Admins can now actually view reports in-game, no more tabbing out!

(yes, clicking on the reporter/reported field will open the options for that user!)

Permissions:

easyadmin.player.reports.view
easyadmin.player.reports.process

---

Cleanup System

Admins now have the ability to clean up Cars/Peds and Objects on the entire server (if onesync is enabled), this should work for all kinds of objects, even ones spawned by Cheaters.

Permissions:

easyadmin.server.cleanup.cars
easyadmin.server.cleanup.peds
easyadmin.server.cleanup.props

---

ea_MenuButton Changes

ea_MenuButton has been changed in a major way, it now uses Keys directly as a way to bind EasyAdmin to a Menu.

Please do note that the ea_MenuButton convar is now only a Default value, once a player joins with the Key set, they can only change it from their Ingame Settings ( Under Controls -> FiveM ), the MenuButton can as such be changed by everyone who wants to change it and is no longer bound to what the Server Owner decides.

As such, please make sure you define your custom Menu Key BEFORE Joining your server, as afterwards you will have to change it manually in the Settings.

---

Translations

Quite a lot of new Strings have been added, and existing ones modified, if you are willing to Translate these new strings and/or correct existing ones, feel free to look at them here, make a Pull Request with your changes :)
However, i would like to ask not to use Translation tools as these are usually inadequate, you should speak the language you are translating fluently.

---

Various Improvements

Visibly, nothing much might have changed, however, code-wise there has been a ton of work to make this update what it is, here are a few noteworthy smaller changes:

• "List" Items are even less broken now
• Prevent an error when screenshotting users with certain cheat menus, this did not affect the screenshot function, however.
• API: Fix BuildServerManagementOptions causing items to be ordered incorrectly.
• Removed "Right" Orientation, it always clashed with screen borders and served no real purpose other than to be broken.
• Menu now makes itself wider in certain menu where this is required
• Various improvements to NativeUI
• Discord Identifiers are now mentioned in the Webhook if possible.´
• Gave the Report and Calladmin webhooks a facelift
• fix/improve various menu options to make them clearer and easier to use.
• Various fixes in the Banlist GUI

Changes from RC1 -> RC2

• Add "Refresh Reports" button to Reports Menu
• Minor NativeUI fixes
• Move ea_MenuButton to KeyMapping System

Changes from RC2 -> 6.2 Release

• Add Refresh Reports button
• Cleanup button now cleans up everything globally if Onesync is on, Cars with players driving them are no longer affected by the cleanup.
• Redesigned all Permission Names
• Update Italian Language
• Menu open time has been optimized a bit
• Updated /easyadmin command and switched to RegisterKeyMapping, improves performance slightly.
• ea_MenuButton is "none" by default now.
• a lot of fixes regarding the Permission Editor

Changes from 6.2 -> Hotfix 6.201

• Improvements to Spanish Localisation (@Antho7Twitch)
• EasyAdmin Permissions are no longer added to the server.cfg, but to easyadmin_permissions.cfg
• Fix a bug that caused permissions to be added to nested config files
• URLs sent as replies by screenshot uploaders should now be detected automatically

Changes from Hotfix 6.201 -> Hotfix 6.202

• Fix a bug that caused EasyAdmin to cause the server to freeze when starting or opening the Menu due to a bug in the Permission Editor, it will attempt to fix the issues it caused on its own.
• Banlist will no longer back itself up if the banlist hasn't been loaded yet.
• Add Support for Project Settings in Fxdk ( @Jaccosf )

Greetings

Supported by:

10% Discount Code: blumlaut-a-1757