๐ Generate โข Share โข Play - Create stunning Minecraft worlds with AI and share them with the community.
Neural Terrain is a web application that uses AI to generate custom Minecraft worlds based on your descriptions. Simply describe your dream world, and our AI will build it for you, complete with terrain, structures, and biomes. Once generated, you can share your worlds with the community and join others' creations.
| Feature | Description |
|---|---|
| ๐ค AI World Generation | Describe any world and our AI will build it using advanced Minecraft world generation |
| ๐ Live Minecraft Servers | Each generated world becomes a playable Minecraft server |
| ๐ฅ Community Sharing | Share your worlds and discover creations by other players |
| โค๏ธ Likes & Comments | Engage with the community through likes and comments |
| ๐ฑ Responsive Design | Works perfectly on all devices |
| ๐ User Authentication | Secure login with Clerk to save your worlds |
| ๐จ Beautiful UI | Modern, gaming-focused interface with smooth animations |
- Sign up for a free account
- Click "New World" and describe your dream Minecraft world
- Watch as AI builds your world in real-time with detailed progress updates
- Our AI agent uses advanced Minecraft world generation tools
- Creates custom terrain, structures, and biomes based on your description
- Generates a complete, playable Minecraft world file
- Uploads the world to cloud storage for instant access
- Your world automatically becomes a live Minecraft server
- Get a unique server URL to share with friends
- Your world appears in the community gallery for others to discover
- Browse and join worlds created by other players
- Like and comment on worlds you enjoy
- View detailed world information and server status
- Next.js 15 with App Router and Turbopack
- TypeScript for type safety
- Tailwind CSS for styling
- Clerk for authentication
- AI SDK for real-time streaming updates
- Next.js API Routes for server logic
- Prisma with PostgreSQL for database management
- Dokploy for Minecraft server deployment
- Vercel Blob for world file storage
- Custom Minecraft Agent using Vercel AI SDK
- Prismarine.js for Minecraft world manipulation
- Advanced Building Tools for block placement and structure creation
- Chunk Generation for optimal performance
- World Upload to cloud storage
- Live Server Deployment via Dokploy
- Custom Hostnames for each world
- Server Status Monitoring
- Thumbnail Generation for world previews
neural-terrain/
โโโ src/
โ โโโ app/ # Next.js App Router
โ โ โโโ api/ # API routes
โ โ โโโ my-worlds/ # User dashboard
โ โ โโโ worlds/ # Community worlds
โ โ โโโ layout.tsx # Root layout
โ โโโ components/ # React components
โ โ โโโ ui/ # Reusable UI components
โ โ โโโ landing/ # Landing page components
โ โ โโโ worlds/ # World-related components
โ โโโ lib/ # Utilities and services
โ โ โโโ world-maker/ # AI world generation
โ โ โโโ dokploy-client/ # Dokploy API client
โ โโโ services/ # Business logic
โ โโโ types/ # TypeScript types
โโโ prisma/ # Database schema
โโโ public/ # Static assets
# Development
npm run dev # Start development server with Turbopack
npm run build # Build for production
npm run start # Start production server
# Database
npm run prisma-dev # Open Prisma Studio
npm run postinstall # Generate Prisma client
# Code Quality
npm run lint # Run ESLint
npm run knip # Check for unused code- Framework: Next.js 15 with App Router and Turbopack
- Language: TypeScript 5.9
- Styling: Tailwind CSS 4
- Database: Prisma + PostgreSQL
- Authentication: Clerk
- Deployment: Dokploy for Minecraft servers
- AI: Vercel AI SDK with custom Minecraft tools
- Minecraft: Prismarine.js ecosystem
- Storage: Vercel Blob
- Real-time streaming updates during generation
- Advanced Minecraft building tools (cubes, spheres, pyramids, lines)
- Custom terrain generation with multiple biomes
- Intelligent structure placement based on descriptions
- Error handling with retry functionality
- Public world gallery with pagination
- Like system for world appreciation
- Comment system for community interaction
- User profiles and world ownership
- Server status indicators
- Responsive design for all devices
- Smooth animations and transitions
- Real-time status updates
- Intuitive world creation flow
- Quick example prompts for inspiration
-
Clone the repository
git clone https://github.com/yourusername/neural-terrain.git cd neural-terrain -
Install dependencies
npm install
-
Set up environment variables
Create a
.env.localfile with the following required variables:# Database DATABASE_URL="postgresql://username:password@localhost:5432/neural_terrain" # Dokploy (for Minecraft server deployment) DOKPLOY_PROJECT_ID="your_dokploy_project_id" HOSTTHING_API_KEY="your_dokploy_api_key" # Clerk (for authentication) NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="your_clerk_publishable_key" CLERK_SECRET_KEY="your_clerk_secret_key" # Vercel Blob (for world file storage) BLOB_READ_WRITE_TOKEN="your_vercel_blob_token"
-
Set up the database
npm run prisma-dev
-
Start development server
npm run dev
This project is licensed under the MIT License - see the LICENSE file for details.
- Vercel AI SDK for the AI capabilities powering world generation
- Dokploy for Minecraft server deployment infrastructure
- Clerk for seamless authentication
- Prismarine.js for Minecraft world manipulation
- Next.js team for the incredible framework
- Minecraft community for inspiration
