TheNinjaRPG 官方源码开源：基于 T3 Stack 的忍者题材网页游戏

This is the official source code for the game www.TheNinja-RPG.com.

💻 Setting up locally

The codebase relies on a variety of external services for e.g. auth, websockets, database, etc. Some of these are next to impossible to replicate locally, but provide free (or very cheap) tiers. To get up and running, it is therefore required to sign up for free accounts on the following services:

• https://clerk.com/ - for auth (required)
• https://uploadthing.com/ - for file uploads (optional)
• https://replicate.com/ - for AI inference (optional)

To get started, copy app/.env.example to app/.env and fill in all variables related to services (*CLERK*, REPLICATE*, UPLOADTHING*).

make setup # Install bun locally
make install # Run bun install
make dbpush # Setup database tables
make seed # Seed database tables
make start # Start development server

• Go to http://localhost:3000 to view the site (use localhost, not 127.0.0.1, or Next.js chunks 403)
• Go to http://127.0.0.1:3001 to manage the database

📚 Learning Guide

The following videos on youtube are recommended to get a quick introduction to the project and the components of the tech stack:

• The official TheNinja-RPG youtube, TNR DevLog
• Next.js, Clerk, tRPC, Planetscale, tailwind: T3 Stack Tutorial
• Drizzle ORM: DrizzleORM Pitch

🔖 Local Development Guide

Various make commands are available; type make help at the root directory for list of available commands. Most importantly:

• Use make bun add [package] if you need to add some package
• Use make build to build the project
• Use make makemigrations to create migrations file for new database changes

🔒 Licensing

This source code is released with no license, meaning that the work is under exclusive copyright. We do not wish for countless of online copies to be released and float around.