Pepper Newspaper

Zeitungsautomaten, Zeitungs-Item und Redaktion für Journalisten – ESX & QBCore.

Überblick

Pepper Newspaper bringt eine Tageszeitung auf deinen Roleplay-Server. Journalisten schreiben im Redaktions-Menü eigene Ausgaben mit Artikeln und Bildern, Spieler kaufen die Zeitung an den Zeitungsautomaten der Stadt. Die Zeitung landet als Item im Inventar, bleibt dort und kann beliebig oft gelesen werden. Das Script ist kostenlos.

Features

• Kauf an allen GTA-Zeitungsautomaten (ox_target, qb-target oder Taste E) – mit Auslage der aktuellen und bis zu 3 älteren Ausgaben
• Zeitungs-Item mit gespeicherter Ausgabe (ox_inventory, qb-inventory, ESX-Standardinventar), Lesezeichen beim erneuten Öffnen
• Redaktion: bis zu 8 Artikel je Ausgabe, Bilder, Vorschau, Veröffentlichen, Archivieren
• Beispielausgabe mit 8 Artikeln, solange die Redaktion noch nichts veröffentlicht hat
• /newsstand markiert den nächsten Automaten auf Karte und Minimap
• Rechte pro Job und Rang, ACE-Recht für Admins, alle Prüfungen serverseitig
• Benachrichtigung aller Spieler bei neuer Ausgabe, optionaler Discord-Webhook

Voraussetzungen

Installation

1. Ressource im Cfx.re-Portal → Granted Assets herunterladen.
2. Nach resources/[pepper]/pepper_newspaper entpacken. Den Ordnernamen pepper_newspaper nicht umbenennen – der ox_inventory-Eintrag ruft pepper_newspaper.useNewspaper auf, und andere Ressourcen nutzen exports.pepper_newspaper.
3. In der server.cfg nach Framework, Inventar und Target eintragen:

ensure oxmysql
ensure es_extended      # oder: ensure qb-core
ensure ox_inventory     # optional
ensure ox_target        # optional
ensure pepper_newspaper

4. Datenbank: Die Tabelle pepper_newspaper_editions wird beim ersten Start automatisch angelegt. Manuell geht es über install/pepper_newspaper.sql (enthält auch das ESX-Item und auskommentiert den Job weazel).
5. Item newspaper anlegen und install/newspaper.png in den Bilder-Ordner deines Inventars kopieren:

-- ox_inventory/data/items.lua
['newspaper'] = {
    label = 'Zeitung',
    weight = 100,
    stack = false,
    close = true,
    server = { export = 'pepper_newspaper.useNewspaper' },
},

-- qb-core/shared/items.lua
newspaper = { name = 'newspaper', label = 'Zeitung', weight = 100, type = 'item', image = 'newspaper.png', unique = true, useable = true, shouldClose = true, description = 'Die aktuelle Ausgabe' },

6. Job für die Redaktion: ESX – Job weazel mit dem SQL am Ende von install/pepper_newspaper.sql anlegen (Ränge 0 Reporter, 1 Redakteur, 2 Chefredakteur). QBCore bringt den Job reporter mit.
7. In config/config.lua Sprache (Config.Locale, Standard 'en'), Preis und Jobs einstellen und den Server neu starten.

Erster Test

1. Server starten – die Konsole meldet „Pepper Newspaper v1.1.0 gestartet (Framework: …)“.
2. /newsstand eingeben und zum markierten Zeitungsautomaten gehen.
3. Am Automaten die Auslage öffnen und die Beispielausgabe kaufen – sie landet als Item newspaper im Inventar.
4. Das Item benutzen: Die Zeitung öffnet sich zum Lesen.
5. Als Journalist (Job aus Config.Jobs) oder Admin /newspaper eingeben und eine eigene Ausgabe veröffentlichen.

Konfiguration

Alle Einstellungen liegen offen (per Asset Escrow lesbar und editierbar):

Automaten und Item

Config.Price = 5
Config.Account = 'money'
Config.Interaction = 'auto'
Config.Item = 'newspaper'
Config.ConsumeOnRead = false
Config.BackIssues = 3

Redaktion und Inhalte

Config.Jobs = {
    weazel = { write = 0, publish = 0, manage = 2 },
    reporter = { write = 0, publish = 0, manage = 0 },
}
Config.EditorAce = 'pepper.newspaper.editor'

Server-Einstellungen

ServerConfig.LogWebhook = ''      -- Discord-Webhook für Veröffentlichungen, Löschungen, Käufe ('' = aus)
ServerConfig.LogPurchases = false -- Käufe mitloggen
ServerConfig.VersionUrl = ''      -- Update-Hinweis in der Konsole (lädt keinen Code nach)

Redaktion

/newspaper öffnet die Redaktion: Ausgabe anlegen, bis zu 8 Artikel mit Überschrift, Text und Bild schreiben, Vorschau ansehen, veröffentlichen. Mit manage-Recht kannst du Ausgaben archivieren oder löschen. Die Beispielausgabe aus config/demo.lua liegt an den Automaten, bis die Redaktion eine eigene Zeitung veröffentlicht – entfernen über „Archivieren“, neu anlegen mit newspaperdemo.

Befehle und Rechte

add_ace group.admin pepper.newspaper.editor allow
add_ace group.admin command.newspaperdemo allow

Rechte in der Redaktion hängen am Job-Rang (write, publish, manage in Config.Jobs); das ACE-Recht gibt vollen Zugriff. Alle Prüfungen laufen serverseitig.

Exports und Events

Server-Exports:

local edition = exports.pepper_newspaper:getCurrentEdition()

FAQ

Die Konsole meldet „Kein unterstütztes Framework gefunden“.

es_extended bzw. qb-core muss in der server.cfg vor pepper_newspaper starten. Alternativ das Framework mit Config.Framework = 'esx' oder 'qbcore' fest einstellen.

Läuft Pepper Newspaper mit Qbox?

Offiziell unterstützt sind ESX Legacy und QBCore. Die Erkennung sucht die Ressourcen es_extended und qb-core; eine eigene Anbindung kannst du in den offenen Dateien unter bridge/ ergänzen.

Die Tabelle fehlt in der Datenbank.

Sie wird beim ersten Start angelegt, wenn oxmysql läuft. Sonst install/pepper_newspaper.sql manuell importieren.

Das Item lässt sich nicht benutzen.

Bei ox_inventory muss der Item-Eintrag server = { export = 'pepper_newspaper.useNewspaper' } enthalten. Bei QBCore braucht das Item useable = true.

Das Item hat kein Bild.

Kopiere install/newspaper.png in den Bilder-Ordner deines Inventars (z. B. ox_inventory/web/images/).

Die Zeitung verschwindet nach dem Lesen.

Im ESX-Standardinventar gibt es keine Item-Metadaten – dort wird die Zeitung immer verbraucht. Mit ox_inventory oder qb-inventory bleibt sie, solange Config.ConsumeOnRead = false ist.

Die Redaktion öffnet sich nicht.

Prüfe Job und Rang in Config.Jobs oder vergib das ACE-Recht pepper.newspaper.editor.

Am Automaten passiert nichts.

Prüfe Config.Interaction: Bei 'key' drückst du E direkt am Automaten, bei ox_target/qb-target muss das Target-Script vor pepper_newspaper starten. Eigene Automaten-Modelle ergänzt du in Config.VendingModels.

Ein Bild wird abgelehnt.

Nur https-Links von Hostern aus Config.ImageHosts sind erlaubt – oder eigene Bilder aus html/img/ der Ressource (z. B. img/harbor.jpg).

Kann die Zeitung für Spieler kostenlos sein?

Ja – setze Config.Price = 0.

Kann ich einen anderen Job als weazel verwenden?

Ja. Trag deinen Job mit den gewünschten Rängen in Config.Jobs ein.

Wie ändere ich Texte oder die Sprache?

Sprache über Config.Locale (de oder en, Standard en); alle Texte stehen in locales/de.json und locales/en.json.

Wie viel Leistung braucht die Ressource?

Gemessen mit resmon: 0,00 ms im Leerlauf und 0,01 ms aktiv.

Gehen beim Update meine Ausgaben verloren?

Nein, Ausgaben liegen in der Datenbank. Sichere vor dem Update deine geänderten Dateien in config/, locales/ und bridge/ und übertrage die Anpassungen in die neue Version. Einen Update-Hinweis in der Konsole aktivierst du über ServerConfig.VersionUrl.

Support

Fragen und Fehler: Öffne ein Ticket in unserem Discord: https://discord.gg/6NaFJWKDYu – verknüpfe deinen Kauf vorher mit /verify.

Permanent auf dem Dev-Server von Pepper Scripts getestet.

Changelog

Aktuelle Version: 1.1.0 (10.10.2026) – Auslage mit älteren Ausgaben, Zeitung bleibt nach dem Lesen im Inventar, Lesezeichen, /newsstand, Beispielausgabe und eigene Bilder aus html/img/. Alle Änderungen stehen in der Datei CHANGELOG.md im Ressourcenordner.

Fehler gefunden? Melde ihn im Discord.