SIMPLIX IT · SCRIPT DOKUMENTATION

IMKEREI &
BRAUEREI.

V4.0.0 · REDM / VORP

Ein komplettes Imkerei- und Brau-System für RedM/VORP: platzierbare Bienenstöcke, Bienenköniginnen, Blumenfelder mit Honig-Bonus, zeitbasierte Braumechanik und ein Hive-Upgrade-System. Diese Seite zeigt dir Schritt für Schritt, wie du das Script installierst und über config.lua auf deinen Server abstimmst.

Abhängigkeiten

VORP Core
VORP Inventory
oxmysql

Installation — Neuinstallation

Lade mulderdev_beekeeping in dein resources-Verzeichnis hoch.
Füge ensure mulderdev_beekeeping in deine server.cfg ein.
Öffne sql.sql und führe Abschnitt A in deiner Datenbank aus.
Starte den Server neu.

Update von einer älteren Version auf V4.0.0

Lade die neuen Dateien hoch (bestehende überschreiben).
Öffne sql.sql und führe Abschnitt B aus.
Prüfe die neuen Bereiche Config.Security, Config.Limits und Config.HiveUpgrades in config.lua.
Starte den Server neu.

Hinweis: Bestehende Bienenstöcke haben danach has_queen = 0 (inaktiv). Spieler müssen einmalig eine Königin einsetzen, um ihre Stöcke zu reaktivieren. Nur sql.sql wird in V4.0.0 verwendet — alte Dateien wie sql_install.sql, sql_migration.sql und sql_update.sql entfallen.

Befehle

Befehl	Wer	Beschreibung
`/bkreload`	Admin	Erzwingt ein vollständiges Prop-Reload bei allen verbundenen Spielern, ohne den Server neu zu starten. Benötigt die Ace-Permission `command.bkreload`.
`/resetplacement`	Spieler	Setzt einen feststeckenden Platzierungsmodus zurück.

Um /bkreload an Admins zu vergeben, füge dies in deine server.cfg ein:

add_ace group.admin command.bkreload allow

Config Referenz — Allgemein & Sicherheit

Setting	Beschreibung
`Config.Locale`	Sprache: `"en"` oder `"de"`
`Config.DevMode`	Debug-Ausgaben in der F8-Konsole
`Config.Security.ValidateConfig`	Gibt beim Start Warnungen für fehlerhafte Config-Werte aus
`Config.Security.RequireOwnership`	Nur Besitzer dürfen ihre Stöcke/Fässer reparieren, füttern oder aufheben
`Config.Security.ServerDistanceChecks`	Server prüft die Spielerdistanz vor sensiblen Aktionen
`Config.Security.InteractionDistance`	Maximale Distanz für Stock-/Fass-Aktionen
`Config.Security.PlacementDistance`	Maximale Distanz zwischen Spieler und Platzierungs-Koordinate
`Config.Limits.MaxHivesPerPlayer`	Maximale Anzahl Bienenstöcke pro Charakter (`0` = unbegrenzt)
`Config.Limits.MaxBarrelsPerPlayer`	Maximale Anzahl Braufässer pro Charakter (`0` = unbegrenzt)

Config Referenz — Hive Upgrades

Setting	Beschreibung
`Config.HiveUpgrades.Enabled`	Schaltet das komplette Upgrade-System an/aus
`Config.HiveUpgrades.MaxLevel`	Standard-Höchststufe für Upgrades (Standard: `3`)
`Config.HiveUpgrades.frame`	Reinforced Frame — reduziert Zustandsverlust beim Ernten
`Config.HiveUpgrades.net`	Protective Net — senkt die Stichchance
`Config.HiveUpgrades.brood`	Large Brood Box — erhöht den Honigertrag
`Config.HiveUpgrades.feeder`	Feeder Chamber — reduziert Futterverbrauch

Jedes Upgrade hat Enabled, Effects (Bonuswerte pro Stufe) und Costs (benötigte Items pro Stufe). Standardkosten nutzen bestehende Items wie wood, wax, honeycomb und sugar_water — passe sie an deine Server-Economy an.

Config Referenz — Beekeeping & Flower Fields

Setting	Beschreibung
`Config.Beekeeping.Prop`	Prop-Modell für platzierte Bienenstöcke
`Config.Beekeeping.HarvestCooldown`	Minuten zwischen Ernten
`Config.Beekeeping.MinHoney` / `MaxHoney`	Basis-Honigertrag (Multiplikatoren wirken zusätzlich)
`Config.Beekeeping.StingChance`	Stichchance in %
`Config.Beekeeping.QueenItem`	Item-Name der Bienenkönigin (Standard: `bee_queen`)
`Config.Beekeeping.QueenLifetime`	Lebensdauer der Königin in Stunden (Standard: `24`, `0` = unbegrenzt)
`Config.FlowerFields.Enabled`	Schaltet das Blumenfeld-System an/aus
`Config.FlowerFields.ShowProximityInUI`	Zeigt einen Näherungsbalken im Stock-Menü
`Config.FlowerFields.BestMultiplier`	Honig-Multiplikator innerhalb eines Feldes (Standard: `2.0`)
`Config.FlowerFields.DefaultMultiplier`	Multiplikator ohne Feld in der Nähe (Standard: `1.0`)
`Config.FlowerFields.FalloffDistance`	Meter hinter dem Radius bis zum Standard-Multiplikator (Standard: `150`)
`Config.FlowerFields.Fields`	Liste der Felder — jeweils mit `x`, `y`, `z`, `radius`, `label`

Blumenfelder hinzufügen

In config.lua unter Config.FlowerFields.Fields:

Fields = {
    { x = 1591.5, y = 2140.4, z = 318.5, radius = 80, label = "Wildblumenwiese" },
    { x = 1264.0, y = 528.0,  z = 88.0,  radius = 60, label = "Sonnenblumenfeld" },
    -- Weitere Felder hier ergänzen...
}

Tipp: Nutze Spooner oder einen Koordinaten-Grabber, um den Mittelpunkt eines Feldes im Spiel zu finden.

Config Referenz — Wild Hives & Brewing

Setting	Beschreibung
`Config.WildHives.Enabled`	Schaltet wilde Bienenstöcke an/aus
`Config.WildHives.Prop`	Prop-Modell (Standard: `s_hornetnest_01x`)
`Config.WildHives.HarvestCooldown`	Minuten zwischen Ernten pro Spieler (Standard: `30`)
`Config.WildHives.StingChance`	Stichchance in % (Standard: `50`)
`Config.WildHives.QueenChance`	Chance in %, beim Ernten eine Königin zu finden (Standard: `15`)
`Config.WildHives.Locations`	Liste der Spawn-Koordinaten
`Config.Brewing.OwnerOnly`	Nur der Fass-Besitzer darf brauen
`Config.Brewing.TheftEnabled`	Erlaubt anderen Spielern, fertige Braue zu stehlen
`Config.Brewing.TheftSuccessChance`	Diebstahl-Erfolgswahrscheinlichkeit in %
`Config.Brewing.Quality.TimeBased`	`true` = Qualität hängt vom Abholzeitpunkt ab
`Config.Brewing.Quality.OvercookTime`	Minuten nach Fertigstellung, bevor der Braue überkocht (Standard: `5`)

Wilde Bienenstöcke hinzufügen

In config.lua unter Config.WildHives.Locations:

Locations = {
    { x = -2312.17, y = -2056.77, z = 82.70, h = 333.54 },
    { x = 1264.82,  y = 528.86,   z = 88.18, h = 235.07 },
    -- Weitere Standorte hier ergänzen...
}

Tipp: Die Z-Koordinate sollte für hängende Nest-Props exakt stimmen — es wird keine automatische Boden-Platzierung durchgeführt.

IMKEREI &BRAUEREI.