Skip to content

Script that lets users save, manage, and switch between custom display names using a persistent SQLite database.

Notifications You must be signed in to change notification settings

lexicon06/customkeeper.js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 

Repository files navigation

πŸ‘• Custom Names & Wardrobe System (sb0t Script)

A persistent custom name / wardrobe system for sb0t-based chat servers. Users can save, switch, cycle, and delete custom display names ("ropas" / "nicks") with a clean letter-based menu and automatic persistence using SQLite.


🧠 Features

  • βœ… Persistent custom names stored in SQLite
  • βœ… Automatic restore of last used name on join
  • βœ… Letter-based menu (no numbers, no spam)
  • βœ… Cycle names forward / backward
  • βœ… Safe deletion with active-name handling
  • βœ… Auto-fallback when active name is removed
  • βœ… Zero user configuration required

🧩 Commands

Command Description
/ropas Show saved custom names (wardrobe)
/nicks Alias for /ropas
/borrar Delete a saved custom name
/nextc Switch to next saved name
/prevc Switch to previous saved name

πŸ“œ How It Works

  1. When a user joins, the script restores their last used custom name.
  2. If a user sets a new custom name, it is saved automatically.
  3. Menus use letters (a–z) instead of numbers.
  4. Only one menu is active per user to avoid conflicts.
  5. Deleting the active name automatically selects a fallback.

πŸ—„οΈ Database Schema

custom_names
---------------------------------------
custom_name_id   INTEGER (PK)
username         NVARCHAR(255)
display_name     NVARCHAR(255)
last_used        DATETIME
created_date     DATETIME

The database file is created automatically:

cn.db

βš™οΈ Installation

  1. Copy the script into your sb0t scripts directory
  2. Restart the bot or reload scripts
  3. The database initializes automatically on first run

πŸ› οΈ Tech Stack


πŸ‘€ Author

Pablo SantillΓ‘n
GitHub: https://github.com/lexicon06


πŸ“„ License

This project is provided as-is for sb0t community usage. You are free to modify and extend it for your own servers.

About

Script that lets users save, manage, and switch between custom display names using a persistent SQLite database.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published