Skip to content

lolmorrisson/gmadmin

Repository files navigation

GMAdmin

GMAdmin is a GM/staff interface addon for WoW 4.3.4 (Cataclysm). It was rebranded from TrinityAdmin so the name is not tied to a single emulator core — the goal is a portable GM admin tool that can adapt to different server stacks over time.

Current status: developed and tested primarily against EmuCoach on WoW 4.3.4 / TrinityCore (Cataclysm). It may work on other TrinityCore 4.3.4 realms today, but command output, security levels, and core patches differ — expect to verify GM commands and chat parsing anywhere else.

This project continues the TrinityAdmin lineage (v2 → v2.5 → GMAdmin 3.0), itself a fork of MangAdmin. See CREDITS.md for upstream authors.

Roadmap

Future work aims to support a broader set of servers and client versions, for example:

  • Cores: TrinityCore, AzerothCore, EmuCoach, and similar forks (with core-specific behavior isolated behind configuration or abstraction layers)
  • Clients: WoW 3.x and 4.x where GM tooling overlaps, rather than hard-coding one expansion

That will require configurable parsing, optional compatibility profiles, and less assumption about exact chat formats — planned for later releases. 3.0.0 is the first public release of the GMAdmin rebrand; compatibility work comes after.

Design

A major goal of this fork is one window, one workflow — each tab is meant to hold its tools inline instead of stacking extra popups you have to hunt down and close by hand. Search, tickets, teleports, and the action log were rebuilt around that idea: results and controls stay on the page, layouts are consistent across tabs, and server output is parsed into the UI rather than left cluttering chat.

Highlights

  • Self-contained tabs — Search, Tickets, Tele, Log, and others work inside the main window without the old detached lookup panels and modal clutter.
  • Tabbed GM toolkit — GM cheats/modes, character tools, NPC/GOB editors, teleports, tickets, server status, action log, online list, search, bots, and settings.
  • ChatBridge parsing — Server, WHO, ticket, and lookup output is routed through structured handlers instead of one giant chat hook.
  • EmuCoach-aware Server tab — Revision/diff metrics, uptime, online counts, event list, reload controls, and weather.
  • Tickets — Fully inline email-style list and detail pane; assign, respond, and teleport without leaving the tab; minimap alert on new tickets.
  • Search — Redesigned SEARCH tab with inline lookup for items, NPCs, gameobjects, quests, spells, skills, and events (with start/stop).
  • Teleports — Missing 4.3.4 Cataclysm zones filled in, plus zone-specific locations; custom teleports for saved recall points and a Location Recorder to capture positions into the addon.
  • Action log — Category filters, color coding, persistence, and broader coverage of GM actions.
  • Live status buttons — Cheat and GM setting toggles highlight green/red based on actual server state.
  • Themes & layout — Configurable colors, draggable window, text branding, and a dedicated Settings tab.

Full list of changes in CHANGELOG.md — includes every major improvement in this fork.

Requirements

  • WoW client 4.3.4 (Interface 40300) — primary target for 3.0.0
  • Server tested on EmuCoach / TrinityCore (Cataclysm); other cores are best-effort until compatibility layers land
  • WoW 3.3.5a may partially work (legacy upstream support) but is not the focus of this release

Installation

Recommended: open GitHub Releases, download GMAdmin-3.0.0.zip (or the latest GMAdmin-X.Y.Z.zip asset), and extract it into Interface/AddOns/.

That zip unpacks directly to a GMAdmin folder — no renaming needed. Do not use the tag page's auto-generated Source code (zip); GitHub names that folder gmadmin-X.Y.Z, which WoW will not load as an addon.

From source (git clone): copy the repo's GMAdmin folder into your client's Interface/AddOns/ directory the same way.

  1. On the server, review GM command security levels if needed (for example, .account onlinelist may require a higher GM level than your staff have).
  2. Log in and open GMAdmin from the side minimenu (GM button at the top) or the main window.
  3. If Tickets or Who tabs error on first open, click the tab again, then use Settings → Change Language to reload once.

Feedback & contributions

Public bug reports, feature requests, and pull requests are handled on GitHub:

Releases (downloads) github.com/lolmorrisson/gmadmin/releases
Bug reports New issue → Bug report
Feature requests New issue → Feature request
Pull requests See CONTRIBUTING.md

Please include GMAdmin version (Settings tab or release tag), WoW client, and server core so issues can be reproduced. Pull requests welcome.

Tabs

Tab Purpose
GM GM modes, cheats, moderation shortcuts, GM level display
CHAR Character modify, level, money, model viewer, ban/kick/delete (with confirmations)
NPC Spawn, modify, waypoint, and emote tools
GOB Nearby objects, target info, D-pad placement, model viewer
TELE Cataclysm zone/area teleports, custom saved locations, location recorder
TICKETS Self-contained ticket queue — list, details, assign, respond, teleport to player
SERVER Core revision, uptime, player counts, diff graph, events, reload, weather
LOG Categorized action log with filters, colors, and persistence
WHO Online list with search and Show GMs filter
SEARCH Self-contained lookup — items, NPCs, GOs, quests, spells, skills, events
BOTS Bot aggressive/passive and related controls
SETTINGS Language, theme colors, version, minimenu toggle

License

GPLv3 — see LICENSE, file headers, and CREDITS.md.

About

GM/staff interface addon for WoW 4.3.4 (Cataclysm)

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages