ENDE
Documentation

Pepper Newspaper

Newspaper stands, a newspaper item and a newsroom for journalists – ESX & QBCore.

Overview

Pepper Newspaper brings a real daily newspaper to your roleplay server. Journalists write their own editions with articles and images in the newsroom, players buy the paper at the city's newspaper stands. The newspaper lands in the inventory as an item, stays there and can be read as often as you like.

Features

  • Buy at every GTA newspaper stand (ox_target, qb-target or E key)
  • Newspaper item that remembers its issue (ox_inventory, qb-inventory, default ESX inventory)
  • Newsroom: up to 8 articles per edition, images, preview, publish, archive
  • Permissions per job and rank, ACE permission for admins
  • Server-wide notification when a new edition is out
  • All checks server-side

Requirements

Requirement Version
FiveM server build ≥ 7290
Framework ESX Legacy or QBCore
Database oxmysql
Optional ox_target / qb-target, ox_inventory

Installation

  1. Download the resource from the Cfx.re Portal (Granted Assets)
  2. Extract it to resources/[pepper]/pepper_newspaper – do not rename
  3. Create the item newspaper (examples for ox_inventory, QBCore and ESX in README.md)
  4. Copy install/newspaper.png into your inventory's image folder
  5. Create the job weazel (ESX: SQL at the end of install/pepper_newspaper.sql) – QBCore's reporter works too
  6. Adjust config/config.lua (language, price, jobs)
  7. Start it in server.cfg after your framework and inventory:
ensure oxmysql
ensure pepper_newspaper

Database tables are created automatically on first start.

Configuration

Setting Default Description
Config.Price 5 Price per newspaper (0 = free)
Config.Account money money (cash) or bank
Config.Item newspaper Item name
Config.Interaction auto auto, ox_target, qb-target or key
Config.Jobs weazel, reporter Ranks for write, publish, manage
Config.EditorAce pepper.newspaper.editor ACE permission for full access
Config.ImageHosts Imgur, Discord, Fivemanage, ImgBB Allowed image hosts

Commands

Command Who Description
/newspaper journalists, admins Open the newsroom

Exports

-- Server: current edition or nil
local edition = exports.pepper_newspaper:getCurrentEdition()

Troubleshooting

  • "No supported framework found" – es_extended or qb-core must start before pepper_newspaper in server.cfg.
  • Item can't be used – with ox_inventory check the entry server = { export = 'pepper_newspaper.useNewspaper' }.
  • Image rejected – only https links from hosts in Config.ImageHosts are allowed.

Found a mistake? Report it on Discord.