# RonaldZav Documentation

Welcome to the official documentation page for the software I develop.

If you need help you can contact through my [discord server](https://ronaldzav.com/discord)


# Instalation

Make sure you follow all the steps in order. If you have a problem, ask for help on my discord server.

1. Download the zip file and unzip it:

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FF9HbW1NZydqqktRXLcOc%2Fimage.png?alt=media&amp;token=36fbf54f-0f20-4b87-bc5e-420d68d11417" alt=""><figcaption></figcaption></figure>
2. Install dependencies:

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F7cLmZA1JDrO7EmaZQR62%2Fimage.png?alt=media&amp;token=dae29b00-ca52-49ed-928b-5303cd892c4a" alt=""><figcaption><p>Use "npm install" command.</p></figcaption></figure>
3. Set discord bot credentials

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FPUoL7NQxNwN3dYobu7fQ%2Fimage.png?alt=media&amp;token=0751e850-5175-43ed-bc5e-7675524acd7b" alt=""><figcaption><p>Write in .env file on root directory</p></figcaption></figure>
4. Edit default configuration and messages

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FkOQd6ovM6IYdimXp8BYM%2Fimage.png?alt=media&amp;token=ac5af7f8-2f90-47bf-bf41-45f0e4479eee" alt=""><figcaption></figcaption></figure>
5. Start software:

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2Fm7vcHFERddmcz77zfMYd%2Fimage.png?alt=media&amp;token=221efe02-7d2d-44a7-a687-73d7721ec2dd" alt=""><figcaption><p>Use "node src/index.js" command to start it.</p></figcaption></figure>


# Configuration

Edit the bot configuration and add the categories (src/config.yml)

Surface Customization:

```yaml
embedColor: "#52e2ff" # Set de embed color (Hex Color)
activity: "developed by ronaldzav.com" # Activity of the bot
icon: "https://page.com/icon.png" # URL to your icon/avatar.
banner: "https://page.com/banner.png" # URL to your banner server.
```

Configure the categories and other features:

```yaml
tickets:
  show:
    panel_icon: true # Show icon in panel
    panel_banner: true # Show banner in panel
    
  transcripts: "1194084695160397866" # Channel where the transcripts will arrive
  
  categories:
    - name: "🌐 Option 1" # Name of category
      description: "My custom description" # Description of category
      categoryId: "1190421130973024256" # ID of the category where the tickets will be created

    - name: "📷 Option 2" # Name of category
      description: "My custom description" # Description of category
      categoryId: "1190421116402028544" # ID of the category where the tickets will be created

    - name: "🚨 Option 3" # Name of category
      description: "My custom description" # Description of category
      categoryId: "1190421148454879302" # ID of the category where the tickets will be created

    - name: "🛒 Option 4" # Name of category
      description: "My custom description" # Description of category
      categoryId: "1190421163306922055" # ID of the category where the tickets will be created

  roles:
    staff: "1156043297630986313" # Role with ticket access
```


# Messages

Customize bot messages and buttons (src/messages.yml)

<pre class="language-yaml"><code class="lang-yaml"><strong>error:
</strong>  botOutPerms: "I don't have enough permissions to do this."
  duplicateCategory: "Duplicate categories were found, check the console. I turned off."
  panelOutdated: "The menu was outdated, it was updated automatically."
  userOutPerms: "You do not have enough permissions."
  internal: "An error has occurred! Notify the support team."
  categoryNotFound: "The category to create the channel was not found! Notify an administrator."
  transcriptChannelNotFound: "The transcript channel was not found! Notify an administrator."

panel:
  openTicket:
    title: "Technical support"
    description: "Welcome to the support panel! Do you have any problem or question? We are here to help you.     Contact us for specialized assistance and quick resolution. Your experience on the server is our priority.    Remember to be respectful with the support members, if you file a ticket with the aim of disturbing you will be sanctioned."

  inTicket:
    title: "Technical support"
    description: "Welcome to the official support system! We are here to help you. Please feel free to raise your queries or issues. Our team will be with you shortly to provide you with the best possible assistance. Thank you for your patience!"

  ticketOpened: "Your ticket has been created, click here &#x3C;newticket>"
  selector: "Select an option!"

events:
  deleteTicket: "You are about to delete this ticket. Are you sure to continue?"
  deleteTicketCanceled: "You canceled the deletion of the ticket."
  countdownDeleteTicket: "This ticket will be deleted in &#x3C;seconds> second(s)."
  transcriptReplySaved: "Transcription saved correctly."
  transcriptSaved: "&#x3C;name>'s Transcription"
  memberAdded: "Member &#x3C;name> was added to the ticket."

buttons:
  delete: "⛔ Delete"
  transcript: "📝 Transcript"
  confirmDeleteTicket: "✅ Confirm"
  cancelDeleteTicket: "❌ Cancel"
</code></pre>


# Common Troubleshooting

1. Gateway Intents Error:

Check that you have these options enabled in your Discord bot. If they are not enabled, enable them.

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FBjGpU6cku1MDHGnLVs95%2Fimage.png?alt=media&amp;token=0f2e84fe-3b14-4cd3-9485-3fdb0f0e5f91" alt=""><figcaption></figcaption></figure>


# License Agreement - No Redistribution

This software is protected by copyright and is the property of RonaldZav.  Unauthorized distribution of this software, included modified or unmodified, is strictly prohibited.

Terms and Conditions

1. **Personal Use**: Personal and commercial use of this software is permitted; however, redistribution is not permitted.
2. **Private Modifications**: You may make modifications to the code for personal and commercial use, but you are not permitted to share, distribute, or publish the code of such modifications.

Limitation of Liability

This software is provided "as is" without warranty of any kind, express or implied. The software owner will not be responsible for maintaining support after 2026.

Contact

If you have any questions about this license agreement, please contact me through discord.


# What is RU-Core?

RU-CORE is the core of an advanced discord bot

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FuJVhAgRqA5CivWbIsWDm%2Fru-core.png?alt=media&amp;token=bf3ddd31-0644-498f-8aca-2441d9d9cd0b" alt="" width="256"><figcaption></figcaption></figure>


# Instalation

Make sure you follow all the steps in order. If you have a problem, ask for help on my discord server.

You must have NodeJS version 18 or higher installed on your system:

1. Download the zip file and unzip it.
2. Use the "npm i" command to install dependencies.
3. Edit the .env file and enter the "TOKEN" and "CLIENT\_ID" of the bot.
4. Run the bot using the command `node run start`

#### IMPORTANT!!! Make sure you have these options activated!

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FRCq0k2uD9B0mvdSgXqkU%2Fimage.png?alt=media&amp;token=01135948-53f0-4286-b6ec-6e5076f741d9" alt=""><figcaption></figcaption></figure>


# Addons

How to install addons to RU-CORE

Download the add-on, unzip it, add the obtained folder to the `./addons/` folder<br>

### Example:

1. Download and unzip the Addon to install.

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2Fhr8qTkW95ptklt8JfrkI%2Fimage.png?alt=media&amp;token=32033cfc-af85-4533-9716-62a4ea6546ed" alt=""><figcaption></figcaption></figure>

2. Copy the unzipped folder to `./addons/`

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FyDrKeQDpPN7NqzCY5Irj%2Fimage.png?alt=media&amp;token=180d973e-f7b6-4f7f-bf2b-1b1267509571" alt=""><figcaption><p>./home/container/addons/</p></figcaption></figure>
3. Restart the software

   <figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FYHvAteBOyy4uLRN7FMCN%2Fimage.png?alt=media&amp;token=6ccc365c-f1b5-4b64-bc75-22851bdb8f2c" alt=""><figcaption></figcaption></figure>


# Instalation

You can pucarse this resource in https\://builtbybit.com/resources/88797

### 🛠️ Installation

1. Download the project files.
2. Open a terminal in the project folder.
3. Install the necessary dependencies:

```bash
npm install
```

### ⚙️ Configuration

This project uses environment variables for easy customization. Create a file named `.env.local` in the project root and add the following content:

```env
NEXT_PUBLIC_SERVER_NAME="Ultimate Network"
NEXT_PUBLIC_SERVER_IP="play.ultimatenetwork.com"
NEXT_PUBLIC_STORE_URL="https://store.ultimatenetwork.com"
NEXT_PUBLIC_DISCORD_URL="https://discord.gg/ultimatenetwork"
```

### 🚀 Commands

#### Development Mode

To edit the website and see changes in real-time:

```bash
npm run dev
```

#### Production Mode

To deploy the website in an optimized way:

1. Build the code:

```bash
npm run build
```

2. Start the server:

```bash
npm start
```

### 🆘 Support

If you need help editing the website, customizing components, or require additional technical assistance, you can request it at: 👉 [ronaldzav.com/support](https://ronaldzav.com/support)


# About

Synthlat is the best open source discord bot in spanish.

### Where can I get it?

You can donwload this bot from github [clicking here](https://github.com/synthlat/).

### How does the bot work?

The bot uses [Discremy](https://docs.discremy.com/) as its base, which is based on DiscordJS. It requires a MongoDB database to work. Make sure you have NodeJS v20 or a higher version

Both the backend and frontend projects have an .example.env file which is a sample of the data that needs to be filled in the .env file *(Create the file if it does not exist)*

After completing the necessary data install the dependencies using `npm i install` and start the bot using `npm run start`

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FIpgi0q42ucgFKwlXYltE%2Fimage.png?alt=media&amp;token=be5ac025-5d6d-4888-b900-8936af4f29b9" alt=""><figcaption></figcaption></figure>


# Instalation


# Setup MongoDB

In this example I use mongodb.com

Create an account and create a Cluster (you can use a free plan)

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FTnYQ5OLgyeH6IO9CIana%2Fimage.png?alt=media&amp;token=e9bfb00e-f1e9-45dd-b24a-3e098eee3a5f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FK4qvdYOgWtYkWrpMLGWC%2Fimage.png?alt=media&amp;token=89cd26be-63cb-4c4c-b28a-6360fc3b548f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FLx8YVI8e30fTpZfEtZOM%2Fimage.png?alt=media&amp;token=feb3024d-caed-4c52-b501-362888ff51a8" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F3VV2IAbDCaPxiILvXsRI%2Fimage.png?alt=media&amp;token=3e60421b-091d-43c3-a466-fba99361a585" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F93fLseDWYYbYRyULfPeC%2Fimage.png?alt=media&amp;token=3ec16921-aa69-45d6-9bbd-b68a6d669e49" alt=""><figcaption></figcaption></figure>

Select Compass option to connect.

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FZklzgEa5C3RbfWP2SWkP%2Fimage.png?alt=media&amp;token=ef519017-786b-4ee8-a616-c76ee781baa3" alt=""><figcaption></figcaption></figure>

If you not have Compass installed, install it from <https://www.mongodb.com/try/download/compass>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FAtSzZaVUA0uaPQhbKiQH%2Fimage.png?alt=media&amp;token=73814fde-2cac-4c9a-a50f-5ca350f4db0f" alt=""><figcaption></figcaption></figure>

Copy the connection URI.

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F7gT21s2nLz6JFUzTOrxn%2Fimage.png?alt=media&amp;token=9577375e-7dd2-43c0-969c-0108f12f8b6d" alt=""><figcaption></figcaption></figure>

Go to "Network Access" in "SECURITY" section and add the IP ADDRESS "`0.0.0.0/0"`

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FpovTw8fS0RS1dZhGiXTC%2Fimage.png?alt=media&amp;token=eef1478a-432d-4d4e-a411-b32e1dd62699" alt=""><figcaption></figcaption></figure>

In your Compass aplication, paste the connection URI, and pess Connect.

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FW2frr4vg27qyM2WSa1VU%2Fimage.png?alt=media&amp;token=cbc2f626-96d5-4d1b-83e0-23fb3ffee553" alt=""><figcaption></figcaption></figure>

Finally create a new database with the collection "guilds".

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FebzTw0I1XZrruIpnEa2U%2Fimage.png?alt=media&amp;token=15f99c29-2d2b-44c4-a25c-de11b71bb665" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2Fa8rRBy1M89BV9linuYmY%2Fimage.png?alt=media&amp;token=fc801b7f-0d23-427e-9013-5ec76bef8329" alt=""><figcaption></figcaption></figure>


# About

Deluxe is a website template for a Minecraft Server developed in NextJS

You can pucharse the [source code or the compiled version in BuiltByBit](https://builtbybit.com/resources/minecraft-website-deluxe-template.54877/)

Preview Images:

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FJTKcSXWawi9csDhgFEKK%2Fimage.png?alt=media&amp;token=905df162-c312-4746-9284-c8415bb8d7d4" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FSLB7ru2UK3XJznq0UtDd%2Fimage.png?alt=media&amp;token=e36306b2-11e1-4eda-be04-2239a5882739" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2Fd08rELJMnJ7gL9tUNVJY%2Fimage.png?alt=media&amp;token=ec07f169-2f69-40ff-a31a-6e253bd8f612" alt=""><figcaption></figcaption></figure>


# Edit Template

How to edit the config of this template

Unzip the resource and open it with Visual Studio and use "Live Preview" addon from Microsoft to can view your changes, you can change all principal options in data.json

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FVBITaXDvUCNTAnAXsuoo%2Fimage.png?alt=media&amp;token=c555a83b-982b-44a2-870e-943bee4fe3ec" alt=""><figcaption></figcaption></figure>

You can edit the Privacy/Terms pages in privacy.md and terms.md files:

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FlAqaSNqQQ5ICFMIsbP6v%2Fimage.png?alt=media&amp;token=d5902c52-225c-4405-b9c8-644d082827b3" alt=""><figcaption></figcaption></figure>


# Setup on Cloudflare

Hosting the website on a free cloudflare web server

Go to Workers and Pages on your Cloudflare account:

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F50b2kRE2nMZCfdCkof1d%2Fimage.png?alt=media&amp;token=e6e9c414-552f-4043-81d5-de4b80555b7a" alt=""><figcaption></figcaption></figure>

Click on "Create":

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FDAVTiJWHCi0x40cdxEcn%2Fimage.png?alt=media&amp;token=5345c264-752b-46e6-8382-d5dce3b94a07" alt=""><figcaption></figcaption></figure>

Select "Pages" option and click on "Upload Resources":

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F0P8YMlSpmv83FjSIGrPs%2Fimage.png?alt=media&amp;token=03b3310f-3821-4770-9077-5ce7256b9c8a" alt=""><figcaption></figcaption></figure>

Complete the information and upload files:

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FAqKMu6NrmftcvVRjlrIY%2Fimage.png?alt=media&amp;token=b6d57db8-df38-4ee5-920b-ebe6a709f992" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FqZhg7yJl344Xdh8DzjuN%2Fimage.png?alt=media&amp;token=8e61ea9c-a382-497d-bc20-f13cae48e294" alt=""><figcaption></figcaption></figure>

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2F5yXSBKOjpFJNGzCqQaka%2Fimage.png?alt=media&amp;token=9435f320-d109-44d5-ad5a-5446d27e4f0f" alt=""><figcaption></figcaption></figure>

Your site is now available:

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FkgNxUBTGvLtNZilxB0jq%2Fimage.png?alt=media&amp;token=c92e2b2f-fa81-4eee-a191-ca799ec790a7" alt=""><figcaption></figcaption></figure>


# Custom Domain

Select "Custom Domains" and click on the button:

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FLHk5FxOKlPeo21QDsuT4%2Fimage.png?alt=media&amp;token=6f2470d2-fb3c-400a-b3d8-b19abade0f25" alt=""><figcaption></figcaption></figure>

Enter your domain an setup it.

<figure><img src="https://515029561-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FyEPu1zHuBZZwXe1LyFa5%2Fuploads%2FNoT4an5kThfiQlAd9Ml2%2Fimage.png?alt=media&amp;token=8e5de7f4-16c6-465e-9250-daa7d3c6771e" alt=""><figcaption></figcaption></figure>


