Installation

The monitor replaces the txAdmin that comes with your server artifacts. txAdmin's resource is always named monitor.

1. Back up

Back up your txData folder and the original monitor folder before replacing anything.

2. Replace the monitor folder

The built-in txAdmin is in your server artifacts:

<artifacts>/citizen/system_resources/monitor

1. Stop the server.
2. Rename the original folder to monitor_backup.
3. Copy the MG monitor folder in its place.

Updating artifacts

Updating your server artifacts restores the original txAdmin. After every artifact update, copy the MG monitor folder back in.

3. Add the permissions to server.cfg

The monitor manages admin permissions in-game, so it needs permission to add and remove aces:

add_ace resource.monitor command.add_ace allow
add_ace resource.monitor command.remove_ace allow
add_ace resource.monitor command.add_principal allow
add_ace resource.monitor command.remove_principal allow

4. Anti-cheat include

The first lines of fxmanifest.lua load WaveShield:

shared_script '@WaveShield/resource/include.lua'
shared_script '@WaveShield/resource/waveshield.js'

Not using WaveShield?

Delete those two lines, or the monitor will fail to start.

5. Start the server

Do a full server restart. Never restart the monitor resource on its own.

On startup, the console prints a compatibility report showing which framework, inventory and other resources were detected.

6. Configure

• Open port 40120 so you can use the web panel from your own computer.
• Set up the Discord bot and role logins for your staff.
• Check config.lua. Everything is set to auto, so you usually only need to change the hospital location:

Config.QBXBridge = {
  Hospital = {
    coords = vector4(-917.0033, -766.269, 17.9402, 0.0),
  }
}

Forcing an integration

If detection picks the wrong resource, set its exact name:

Config.Compatibility.Framework = 'qb-core'
Config.Compatibility.Inventory = 'qb-inventory'
Config.Compatibility.Appearance = 'illenium-appearance'

Use false or 'none' to turn a category off. Restart the whole server after changing it.

Custom database columns

If your framework uses different table or column names, set them in Config.Compatibility.Database:

Database = {
  PlayersTable = 'players',
  VehiclesTable = 'player_vehicles',
  CitizenIdColumn = 'citizenid',
  LicenseColumn = 'license',
  MoneyColumn = 'money',
  JobColumn = 'job',
  GangColumn = 'gang',
  CharInfoColumn = 'charinfo'
},

Vehicle defaults

VehicleDefaults = {
  Garage = 'pillboxgarage',  -- garage for vehicles given with /givecar
  State = 1,
  PlatePrefix = 'TX'
},

Troubleshooting

• /pedmenu opens the wrong menu: your appearance resource registers its own /pedmenu. Disable it there (Config.EnablePedMenu = false) so txAdmin owns the command.
• Actions do nothing: check the startup compatibility report and force the correct resource in Config.Compatibility.
• The panel is still the old txAdmin: the original monitor folder is still in your artifacts. Repeat step 2.