FoXyTrash

Current Version: 1.2

🔄 Client-Side Mod

FoXyTrash runs as -mod= (not -serverMod). Players subscribe on the Workshop.

Sponsored by INK GAMING

Server IP: 45.45.238.222:2302 Discord: discord.gg/inkgamingcommunity

What is FoXyTrash?

A fully featured recycling bin mod for DayZ. Players fill wheelie bins with items and recycle them - permanently deleting the contents. Bins auto-recycle on a timer, notify nearby players, log to Discord, and support 13-colour spray paint. Deployed from kits via hologram placement, packed back with a Screwdriver. Includes a spawner for static bins, an admin wrench, a full command suite, and a comprehensive third-party API.

Bin Types

4 colours - Black, Blue, Green, White - each in three forms: • Player Bins - WheelieBin_[Colour] (scope 2 - kit-deployed, packable, loot economy via types.xml) • Static Bins - WheelieBin_Static_[Colour] (scope 1 - spawner/admin/wrench placed, non-packable) • Kits - WheelieBin_[Colour]_Kit (scope 2 - hologram placement preview)

All bins have an animated open/close lid - items add when open, recycle when closed.

Core Features

• Manual Recycle - Destroys all items, closes lid, plays sound, randomised notification • Auto-Recycle - Configurable timer (default 30 min); notifies nearby players within a set radius • Cooldown - Per-bin cooldown (default 5s) with randomised humorous messages • Kit System - Hologram placement, pack/unpack and dismantle via Screwdriver • Sound Effects - Recycle and spray can sounds, toggleable in config • Persistent Spray Skins - Survive restarts via OnStoreSave/OnStoreLoad • 10×50 Cargo - 1,300 HP bins with damage states

Spray Paint System

13 spray paint cans. Hold a can, target any bin - continuous action (default 5s) applies a custom skin to all surfaces. Can is consumed; skins persist through restarts.

Colours: Black, Blood, Blue, Brown, Cyan, Green, Lime, Orange, Pink, Purple, Red, White, Yellow

Admins can spray via !FoXyTrash spray (no can) and remove with !FoXyTrash clearspray. Third-party mods remap textures via the Skin Override Registry - one RegisterSkinOverride call, no script overrides needed.

Configurable Messages

8 categories, each with multiple randomised responses - PlayerRecycled / PlayerRecycledEmpty (recycle or empty bin), AutoRecycled (fires near a player), CooldownActive (on cooldown), and the admin responses AdminPlace / AdminRemove / AdminList / AdminNearest.

Placeholders: %ItemCount%, %Count%, %ClassName%, %Distance%

Discord Integration

• 3 independently-toggled events: OnPlayerRecycled, OnAutoRecycled, OnAdminCommand • Rich embeds with configurable bot name, colour, and logo • Rate limiting with queued delivery, field-split overflow protection, and placeholder-webhook detection

Spawner System

JSON-configured spawn points (classname, position, orientation). Bins respawn on restart unless one already exists at that position (1m duplicate detection). Ships with 3 example bins at Green Mountain. Managed via admin commands, the wrench, or direct JSON editing.

In-Game Admin Commands

Prefix !FoXyTrash (configurable), restricted to Admins.AdminSteamID: • reload - Hot-reload config from disk • place <classname> - Spawn a bin at your position, save to config • remove - Remove nearest spawner bin within 5m • list / nearest - Show spawn point count / nearest bin and distance • spray <colour> / clearspray - Spray or clear nearest bin within 5m

With Expansion Chat: Direct, Global, Admin, Transport, Team channels. Without: Direct only.

Admin Wrench Tool

Admin-only in-hand tool (FoXyTrash_Wrench) for managing static bins without chat commands. Extends the vanilla Wrench, syncs admin status when picked up, never consumed on use. • Place - Toggle a hologram, cycle colours, drop static bins - saved to the spawner config • Move - Pick up a static bin and re-place it. Crash-safe, with auto-restore on drop, logoff, or collision • Configurable - The PlaceableBins array controls which classnames the wrench handles • Expansion safe - Spawns server-side, works inside safe zones

Third-Party API

1,271-line dependency-free public API - use #ifdef FoXyTrash to compile without it. • 24 ScriptInvoker Events - recycle, spray, spawn/remove, admin, config reload, and full wrench coverage • 5 CancelToken Hooks - veto recycle, auto-recycle, spray, and wrench place/move • 158 Static Methods - bin/spawner queries, spray control, config CRUD, Discord, per-bin data, command execution • Skin Override Registry - prefix-based texture remaps for third-party skins • Command Dispatcher - run admin commands programmatically

Optional Integrations

Auto-detected, none required: DayZ Expansion (Core, Chat) - enhanced toasts and multi-channel chat.

Configuration

Config: $profile:\FoXyMods\FoXyTrash.json Logs: $profile:\FoXyMods\Logs\FoXyTrash.log Auto-generated with working defaults on first run. Auto-migrates between versions with backup. 7 logger modes, 4 timestamp formats (UK, US, EU, ISO).

Links

FAQ & Full Documentation Discord - Support & Repacks FoXyMods Website Support Development FoXy Workshop

Usage & Terms