Transform server moderation into a gamified survival experience. New members start a countdown; fail to act and they’re “kicked” into roleplay zones where they complete tasks, earn XP/tokens, and climb leaderboards to regain privileges.

• Survival timer with automated DMs and reminders
• Soft “kick” via role assignment (no actual bans)
• Redemption via configurable task system (quiz, meme, raid, wheel, dare)
• XP and token economy with bribes/extensions
• Real-time leaderboards and progression roles

Use this bot to increase engagement, onboard creatively, and keep moderation fun.

• Survival core
  • 24h configurable countdown with reminder schedule
  • DM welcomes, reminders, and kick notices
  • Role-based access after “kick” (e.g., Jail, Shadow Realm)
• Tasks & economy
  • Task types: quiz, meme, raid, wheel, dare (+ custom)
  • Rewards: XP and tokens; token bribes extend time
  • Availability: difficulty, cooldowns, requirements, expirations
• Community systems
  • Voting (save/doom), alliances, token trading (optional)
• Leaderboards
  • Survivors, XP, tokens, achievements; seasonal support

• Node.js 18+
• Discord.js v14
• MongoDB (Mongoose)

1. Clone and install

git clone <repository-url> cd kick-discord-bot npm install

2. Configure environment Copy env.example to .env and fill in values.

3. Run

npm start

Environment variables (see env.example for full list):

Roles you’ll likely want:

• Kicked (restricted)
• Advanced Survivor (perks)
• Hall of Fame (recognition)

Suggested channels:

• Public: #general, #announcements, #hall-of-fame
• Kicked-only: #jail, #shadow-realm, #cryosleep, #kicked-common-room
• Advanced: #survivor-lounge, #elite-tasks, #survivor-leaderboard

• /survive – Show your status, time remaining, XP, tokens
• /tasks – List active tasks and rewards
• /leaderboard – Show top survivors
• /bribe <amount> – Spend tokens to extend survival
• /wheel – Spin for random outcomes
• /vote <user> <save|doom> – Community vote

Admin commands:

• /admin-add-task – Create a task (type, title, description)
• /admin-reset-user <user> – Reset user state

User { userId, guildId, joinTime, kickTime, currentRole: 'normal'|'kicked'|'advanced_survivor'|'hall_of_fame', survivalCount, totalXP, tokens, remindersSent: Number[], achievements[], alliances[], voteHistory[] } Task { taskId, type, title, description, rewardXP, rewardTokens, active, difficulty, requirements: { minSurvivalCount, minXP, roleRestriction }, completionData, cooldown, maxCompletions, tags } Leaderboard { guildId, type, entries[{ userId, value, rank, additionalData }], season, metadata }

• Local: npm start
• PM2 (example):

npm i -g pm2 pm2 start npm --name kick-survival-bot -- start pm2 save

• Docker (example):

# simple example FROM node:18-alpine WORKDIR /app COPY package*.json ./ RUN npm ci --only=production COPY . . CMD ["npm", "start"]

• Seasonal events, richer task flows, better voting & alliance UX
• Optional web dashboard for analytics and configuration
• Extensible plugin API for custom task types

Issues and PRs welcome. Please:

• Use conventional commits if possible
• Add/adjust tests where relevant
• Keep code readable and typed where applicable

MIT

• Telegram: @lorine93s
• Open an issue on GitHub