README.md

next-litebans

A web interface for LiteBans, built on top of:

👾 Demo

You can view a demo of the project here.

P.D: All punishments in the demo are randomly added to the database with a list of random premium player names as punished players, and with a predefined list of reasons.

🚀 Deployment

Prerequisites

• Node.js v20.x or higher
• Litebans working on MySQL, MariaDB or PostgreSQL

Installation

1. Clone the repository with git clone https://github.com/YoSoyVillaa/next-litebans.git
2. Install the dependencies with npm install
3. Copy the .env.example file to .env and fill in the required fields. For help check this
4. If you are using PostgreSQL, check PostgresSQL Configuration
5. Config the website (configuration)
6. Run npm run setup:db:generate to generate the Prisma client
7. Run npm run build to build the project
8. Run npm run start to start the server

Database URL

You will need to set the DATABASE_URL environment variable in the .env file. If you don't know the URL template, you can check the following examples for both MySQL and PostgreSQL:

MySQL URL Configuration

DATABASE_URL="mysql://user:password@host:port/database"

PostgreSQL URL Configuration

DATABASE_URL="postgresql://user:password@host:port/database?schema=public"

PostgresSQL Configuration

If you are using PostgreSQL, you need to delete all the models in the prisma/schema.prisma file and change the provider to postgresql, or replace the file content with:

generator client {
  provider = "prisma-client-js"
}

datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

Update the URL in the .env file with the PostgreSQL connection string.

Then, run npm run setup:db:pull to pull the database schema.

🛠️ Configuration

You can configure any website option on config/site.ts, such as the page title, icon, and more.

🖼️ Images

You can place the images in the public/ folder, then you can use them in the website with the / path. But, if you want to use an external link images, you will need to add the following config to the next.config.js file:

const nextConfig = {
  images: {
    remotePatterns: [
      // One object for each domain
      {
        protocol: 'https',
        hostname: 'domain.example',
      }
    ]
  }
};

🌍 Internacionalization

To configure the available languages, you can edit the config/site.ts file, modifying the languages object, then, you can edit existing translations in the language/ folder, or create new ones copying the existing ones and changing the values.

👤 Bedrock compatibility

If your server allow Bedrock players through Geyser and/or Floodgate, you can enable the Bedrock compatibility mode in the config/site.ts file, setting the bedrock property to true. Then, configure the name prefix for Bedrock players, to replace the skins with the default Steve skin.

  bedrock: {
    enabled: true,
    prefix: "BP_", // Prefix for Bedrock players
  },

Warning

If you are using a special character for your Bedrock players, such as *.+?^${}()|[\]\\, etc., you will need to enter src/utils/bedrock.ts, and change the line 13 to const bedrockPrefixRegex = new RegExp(`^\\${siteConfig.bedrock.prefix}`);, escaping the special character with a double backslash.