initial

Author: MrPeterss

.env.template

@@ -0,0 +1,13 @@
+NODE_ENV="dev"
+
+# Discord API credentials
+DISCORD_BOT_TOKEN=
+DISCORD_GUILD_ID=
+
+# Pterodactyl configuration
+PTERODACTYL_URL=
+PTERODACTYL_SERVER_ID=
+PTERODACTYL_API_KEY=
+
+# MongoDB connection URI
+DATABASE_URI=

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.github/pull_request_template.md

@@ -0,0 +1,35 @@
+<!-- IF A SECTION IS NOT APPLICABLE TO YOU, PLEASE DELETE IT!! -->
+
+<!-- Your title should be able to summarize what changes you've made in one sentence. For example: "Exclude staff from the check for follows". For stacked PRs, please indicate clearly in the title where in the stack you are. For example: "[Eatery Refactor][4/5] Converted all files to MVP model" -->
+
+## Overview
+
+<!-- Summarize your changes here. -->
+
+## Changes Made
+
+<!-- Include details of what your changes actually are and how it is intended to work. -->
+
+## Test Coverage
+
+<!-- Describe how you tested this feature. Manual testing and/or unit testing. Please include repro steps and/or how to turn the feature on if applicable. -->
+
+## Next Steps (delete if not applicable)
+
+<!-- If this is part of a multi-PR change, please describe what changes you plan on addressing in future PRs. -->
+
+## Related PRs or Issues (delete if not applicable)
+
+<!-- List related PRs against other branches/repositories. -->
+
+## Screenshots (delete if not applicable)
+
+<!-- This could include of screenshots of the new feature / proof that the changes work. -->
+
+<details>
+
+  <summary>Screen Shot Name</summary>
+
+  <!-- Insert file link here. Newlines above and below your link are necessary for this to work. -->
+
+</details>

.github/workflows/deploy.yml

@@ -0,0 +1,47 @@
+name: Build and Deploy to Cloud VM
+
+on:
+  push:
+    branches:
+      - "main"
+
+jobs:
+  setup-build-publish-deploy:
+    name: Setup, Build, Publish, and Deploy
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v3
+
+      - name: Auth Docker
+        uses: docker/login-action@v2
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_PASSWORD }}
+
+      - name: Get SHA
+        id: vars
+        run: echo "::set-output name=sha_short::$(git rev-parse --short HEAD)"
+
+      # Build the Docker image
+      - name: Build
+        run: |-
+          docker build --tag "cornellappdev/discord-bot:${{ steps.vars.outputs.sha_short }}" .
+      - name: Publish
+        run: |-
+          docker push "cornellappdev/discord-bot:${{ steps.vars.outputs.sha_short }}"
+      - name: SSH & Deploy
+        uses: appleboy/ssh-action@master
+        with:
+          host: ${{ secrets.SERVER_HOST }}
+          username: ${{ secrets.SERVER_USER }}
+          key: ${{ secrets.PRIVATE_KEY }}
+          script: |
+            export BOT_IMAGE_TAG="${{ steps.vars.outputs.sha_short }}"
+            docker stop discord-bot-backend-web-1
+            docker rm discord-bot-backend-web-1
+            yes | sudo docker container prune
+            yes | sudo docker system prune
+            cd discord-bot
+            docker compose -p discord-bot-backend up -d

.gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+.env
+node_modules/
+*.log
+service_account.json
+secrets/
+ca-certificate.crt
+coverage/

.prettierignore

@@ -0,0 +1,3 @@
+# Ignore artifacts:
+build
+coverage

.prettierrc

@@ -0,0 +1 @@
+{}

Dockerfile

@@ -0,0 +1,29 @@
+# Build stage
+FROM node:24.13.1-alpine AS builder
+
+WORKDIR /usr/app
+
+COPY package.json package-lock.json ./
+RUN npm ci --only=production && npm cache clean --force
+
+# Production stage
+FROM node:24.13.1-alpine
+
+WORKDIR /usr/app
+
+# Copy dependencies from builder
+COPY --from=builder /usr/app/node_modules ./node_modules
+
+# Copy application files
+COPY package.json package-lock.json ./
+COPY tsconfig.json ./
+COPY src ./src
+
+# Run as non-root user
+RUN addgroup -g 1001 -S nodejs && \
+  adduser -S nodejs -u 1001 && \
+  chown -R nodejs:nodejs /usr/app
+
+USER nodejs
+
+CMD ["npm", "start"]

README.md

@@ -0,0 +1,17 @@
+# Discord Minecraft whitelist bot
+
+TypeScript [Discord.js](https://discord.js.org/) bot that registers `/whitelist` and `/unwhitelist` slash commands, syncs with a Minecraft server over Pterodactyl (WebSocket console), resolves names via Mojang, and stores per-Discord-user slots in MongoDB.
+
+## Setup
+
+Copy `.env.template` to `.env` and set:
+
+- **Discord:** `DISCORD_BOT_TOKEN`, optional `DISCORD_GUILD_ID` (guild-scoped commands if set; otherwise global).
+- **Database:** `DATABASE_URI`
+- **Pterodactyl:** `PTERODACTYL_URL`, `PTERODACTYL_SERVER_ID`, `PTERODACTYL_API_KEY`
+
+Run: `npm install` then `npm run dev` or `npm start`.
+
+## Docker
+
+Build and run with `docker compose`. The compose file expects `BOT_IMAGE_TAG` in the environment (see `.github/workflows/deploy.yml`).

docker-compose.yml

@@ -0,0 +1,7 @@
+services:
+  web:
+    image: cornellappdev/discord-bot:${BOT_IMAGE_TAG}
+    env_file: .env
+    volumes:
+      - ./ca-certificate.crt:/usr/app/ca-certificate.crt:ro
+    restart: on-failure