Activity Logs
A complete record of everything that happens in a gang, for the gang leadership and for staff.
๐ What's logged
| Category | Examples |
|---|---|
| Members | Invites, joins, removals, rank changes, leaving, leadership transfer, admin changes |
| Ranks | Ranks created, edited, deleted or reordered |
| Money | Deposits, withdrawals, laundering runs |
| Upgrades | Upgrades bought, branding changes, tier promotions and requests |
| Hideout & stash | Stash opened, items put in and taken out, furniture, interiors, outfits, police stash searches |
| Vehicles | Bought, sold, taken out, stored, towed |
| Street | Drug sales, protection money, business sale cuts, graffiti, turfs gained or lost, hotspots, airdrops, market, black medic |
| Wars & raids | Wars declared, started, won, lost, surrendered; rivalries; police raids and seizures |
| Contracts | Started, completed, failed |
| Pass & spin | Pass unlocks and claims, daily spin prizes, leaderboard wins |
Every entry says who did it, what happened and when. Members are shown by their alias.
Drug sales and stash
- Every drug sale by a member is logged with the item, amount, price and turf. This includes sales reported by other drug scripts through DrugSold.
- Opening the gang stash is logged at most once every 5 minutes per member.
- Items put in or taken out of the gang stash and furniture stashes are logged one by one, including by police during a raid.
Stash item logging needs ox_inventory. qb-inventory and tgiann-inventory don't tell other scripts when items are moved, so only stash opens are logged there.
๐ฑ Where to see it
| Who | Where |
|---|---|
| Gang members | Tablet โ Activity (at the hideout desk) |
| One member's history | Tablet โ Members โ click a member |
| Staff | Admin โ Gangs โ [gang] โ Activity tab. Shows each alias with the real name |
| Discord | A webhook per gang (below) |
Both the tablet and the admin tab can filter by category, member and date (24 hours, 7 days, 30 days, any time). Filtering happens on the server, so Load older searches the full history.
๐ฌ Discord webhook per gang
Staff can give each gang its own Discord channel for its activity log:
- Create a webhook in the Discord channel.
- Admin โ Gangs โ [gang] โ General โ Tablet and Discord.
- Paste it into Discord activity webhook and save.
Every activity entry is posted there under the gang's name, logo and colour. Entries are batched every 5 seconds (up to 15 per message) so busy gangs don't get rate-limited. Only staff can see or change the URL.
โ๏ธ Settings
shared/core.lua โ ActivityLog:
| Setting | Default | What it does |
|---|---|---|
ActivityLog.DrugSales | true | Log every drug sale by a member |
ActivityLog.StashOpened | true | Log stash opens (once per 5 minutes per member) |
ActivityLog.StashItems | true | Log items put in and taken out (ox_inventory only) |