Mods / Ding-a-Ling

Tags:
Storage Addon Audio Bell Manager Content-Mod
Author:
TobseStone
Side:
Both
Created:
Apr 18th at 10:12 AM
Last modified:
Apr 19th at 12:06 PM
Downloads:
44
Follow Unfollow 7
Latest release (for Vintage Story 1.22.0-rc.1 - 1.22.0-rc.10, potentially outdated):
Dingaling v1.0.5.zip  1-click install

Ding-A-Ling

by TobseStone

Ding-A-Ling is a fully customizable event bell system designed to monitor nearby inventories (such as chests) and notify players about changes in real time.
It combines immersive visuals, flexible notification systems, and advanced filtering into a single, lightweight block.


Core Functionality

Ding-A-Ling detects inventory changes in adjacent containers and reacts instantly when items are added or removed.

When triggered, the bell can:

  • Play a configurable bell sound
  • Display a chat notification
  • Show animated center-screen text
  • Spawn visual particle effects
  • Animate the bell with realistic swinging motion

All systems are fully configurable through an in-game GUI.


Notification System

The notification system is highly flexible and supports multiple output channels:

Chat Notifications

  • Sends messages when inventory changes occur
  • Fully customizable message text
  • Supports range limitation (12–64 blocks or server-wide)

Center Screen Text

  • Displays large animated text in the center of the screen
  • Adjustable:
    • Font size
    • Color
    • Screen position (Top / Middle / Bottom)
    • Optional frame/border

Particle Effects

  • Multiple visual presets available:
    • Spark Burst
    • Smoke Puff
    • Glow Ring
    • Shine Burst
    • To Player (guiding particles flying directly to the player’s face)

Particle color is fully customizable.


Sound System

Includes 5 selectable bell sound presets:

  • Classic Bell
  • Deep Bell
  • Clear Bell
  • Bright Bell
  • Short Bell

Each preset modifies pitch and tone for different acoustic styles.


Range System

The notification range can be adjusted via GUI:

  • 12 blocks
  • 24 blocks
  • 36 blocks
  • 64 blocks
  • Server-wide

Important:

  • Range applies to chat and center text only
  • Particle effects always remain local for immersion

Access Control System

Ding-A-Ling includes a full permission system:

  • Public – everyone receives notifications
  • Private – only the owner receives notifications
  • Team – only selected players receive notifications

Team members can be defined via name list (comma-separated).


Smart Item Filtering

Advanced filtering allows precise control over triggers:

Allowed Items (Whitelist)

  • Only specific items trigger the bell

Blocked Items (Blacklist)

  • Prevent specific items from triggering events

If the whitelist is empty, all items are allowed by default.


Visual Variants

The bell system supports multiple visual combinations:

  • Different wood types (frame appearance)
  • Different metal types (bell color/material)
  • Animated pose states (swinging positions)
  • Directional placement (block orientation)

Result:
A large number of visual variants depending on crafting materials.


Animation System

When triggered, the bell performs a smooth multi-step swing animation using multiple pose


GUI System

The in-game GUI allows full configuration:

  • Toggle all systems (sound, chat, particles, animation, center text)
  • Dropdown selections for:
    • Sound preset
    • Particle preset
    • Range
    • Text position
    • Colors
  • Editable custom message
  • Inventory-based item filters (whitelist/blacklist)
  • Access control settings
  • Test buttons for live preview

Designed for clarity and scalability with room for future extensions.


Use Cases

Ding-A-Ling is ideal for:

  • Storage monitoring
  • Multiplayer base management
  • Automated supply notifications
  • Trade and logistics systems
  • Alert systems for shared containers
  • Immersive feedback for inventory interactions

Created by TobseStone

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
1.0.5 dingaling
1.22.0-rc.1 - 1.22.0-rc.10
27 Apr 19th at 12:06 PM Empty Dingaling v1.0.5.zip 1-click install
1.0.0 dingaling
1.22.0-rc.1 - 1.22.0-rc.9
17 Apr 18th at 10:34 AM Empty Ding-a-Ling.zip 1-click install

3 Comments (oldest first | newest first) (threaded | flat)

TobseStone , Apr 19th at 11:53 AM

Ding-A-Ling v1.0.5 – Changelog (+RC10)

Spoiler

🔔 Ding-A-Ling v1.0.5 – Changelog

✨ New Features

  • Manual Trigger System
    • Added optional manual activation using Sneak + Right Click
    • Can be enabled/disabled via GUI toggle
  • Proximity Trigger System
    • Bell can now react to nearby entities
    • Fully configurable via GUI:
      • Trigger Modes:
        • Players
        • Hostile Creatures
        • All Entities
      • Adjustable detection range (1–64 blocks)
  • Advanced Notification Range
    • Range can now be selected via dropdown:
      • 12 / 24 / 36 / 64 blocks
      • Server-wide option for global notifications
  • Cooldown System
    • Added configurable notification delay to prevent spam
    • Options from 500ms up to 5000ms
  • Center Text Improvements
    • Position can now be set:
      • Top / Middle / Bottom
    • Optional frame/border toggle
    • Improved readability and visual feedback
  • Expanded Filtering System
    • Whitelist and Blacklist increased:
      • Now supports 12 slots per list
    • Better control over which items trigger notifications

🧠 GUI Improvements

  • Complete GUI overhaul
    • Reduced size for better scaling compatibility
    • Fixed layout issues (text overflow, spacing)
  • New multi-page interface
    • Page 1: Core settings (alerts, visuals, sound)
    • Page 2: Advanced triggers (manual, proximity, filters)
  • Improved structure and readability
    • Clear section separators
    • Better alignment and grouping
  • Added test buttons
    • Test sound directly in GUI
    • Test particle effects
    • Test center text preview

🔊 Sound & Effects

  • Fixed sound playback issues during world loading
  • Improved stability of sound triggering system
  • Refined particle presets, including:
    • Directed particles towards player ("To Player" effect)

🛠️ Fixes

  • Fixed crash caused by sound system initializing too early
  • Fixed GUI rendering crash (invalid bounds / blur issue)
  • Fixed recipe visibility issues in handbook and creative menu
  • Fixed variant handling (wood + metal combinations)
  • Fixed missing or incorrect block names
  • Fixed animation desync issues
  • Fixed item filtering inconsistencies
  • Fixed server/client sync issues in GUI settings

⚙️ Technical Improvements

  • Improved client-server synchronization
  • Safer packet handling
  • More robust entity detection logic (no API dependency issues)
  • Cleaner internal structure for future expansions

📦 Summary

Version 1.0.5 transforms Ding-A-Ling into a fully configurable alert system, combining:

  • Inventory monitoring
  • Manual triggering
  • Entity proximity detection

All with a clean, expandable GUI and improved stability.

SeniLiX, Apr 18th at 11:06 AM (modified Apr 18th at 11:08 AM)

Suggestions:

  • A manual trigger.
  • A proximity trigger (When certain entities gets within range. (Hostile mobs or player factions)
  • A 3 block high variant of the bell.

I think this would make for a fun town and/or church bell which you can ring yourself.