Browse docs
Business and Announcements
Enable the feature
Jobs Base owns this feature; Jobs Creator is an optional editor. Registered agencies and businesses use the same permission and duty rules.
Configure global behavior under /jobconfig → Jobs Base → Jobs → Business & announcements, then enable the intended capabilities for each job. Creator exposes the same saved settings. File defaults are Config.Business; saved configurator overrides take precedence.
| Global setting | Default / purpose |
|---|---|
enabled | Global feature switch |
durationSeconds | 8-second notice |
cooldownSeconds | 300-second employee cooldown per job |
position | Default notice position; top-center by default |
maxPending | Three queued notices by default |
announceExclusionZones | Automatic restricted-zone notices |
discord.publicEnabled, discord.adminEnabled | Independent opt-in Discord outputs |
The job's businessSettings contains statusEnabled, announcementsEnabled, requireOnDuty, imageUrl, openColor, closedColor, openSprite, closedSprite and closedAlpha. Opening/closing and announcements are opt-in per job. The image is optional; sprite 0 retains the station's icon. Existing disabled station blips stay disabled.
Publish from the tablet
Grant Change business status (34) and/or Publish announcements (35) through the existing job roles/units. The app launcher is controlled by Config.Tablet.apps.business and appears only when the player can use the feature.
- Open Tablet → Business & announcements.
- Change opening status, or select an announcement, promotion or event.
- Enter a message of up to 240 characters and submit.
An empty opening/closing message uses the localized default. There is no /business command or separate business radial entry. Opening the business does not change employee duty.
The server derives the publisher, image and recipients. Accepted notices reach connected players. Opening state survives resource/server restarts; old transient notices are not replayed after reconnecting.
History and personal placement
The app shows the current authorized job's history: timestamp, employee/resource, action and message. It includes accepted opening changes, announcements, promotions, events and restricted-zone notices performed after this feature's update. Older actions are not reconstructed.
History uses sky_jobs_logs and its retention policy. The first page contains up to 25 entries, with older entries loaded by ID cursor. Permission, duty and enabled-feature checks also apply to history.
Under /notifications → Business announcements or the matching Tablet Settings page, players can place their own notice. Reset → Apply removes the personal override and follows the server's position again. These preferences do not grant publishing permission.
Discord outputs
Enable the public and administrator outputs independently, then configure their private URLs in sky_jobs_base/config/webhooks.lua under Webhooks.businessAnnouncements.public and .admin. Restart Jobs Base after editing webhooks. Keep them out of client files and /jobconfig.
The public output contains the business/faction name, type, message and configured image. The separate administrator output adds the action origin and employee context. Rejected requests and silent status updates do not publish Discord notices. A Discord failure does not undo a successful in-game announcement.