⚙️ Configuration (`config.yml`)

This file controls the core mechanics of the plugin.

The config.yml file is the heart of CodellaCells, controlling all core mechanics. Here's a detailed breakdown of the key sections:

Licensing & World Settings

# CRITICAL - Enter your license key here
license: "your-license-key-here"

# The world where cells are generated
cell-world: "cells_world"

Generation Parameters

generation:
  # How often (in ticks) the queue processes new cells (20 ticks = 1 second)
  queue-process-delay-ticks: 20
  
  # Initial radius of new cells
  default-cell-size: 15
  
  # Distance between cell centers - MUST BE > (default-cell-size * 2)
  cell-spacing: 100
  
  # Material for the center block and floor
  platform-material: BEDROCK
  floor-material: GRASS_BLOCK
  
  # Y-level for the center block
  platform-y-level: 64

World Border Settings

world-border:
  # Enable/disable the visual cell border
  enabled: true
  # Distance from edge where warning effect appears
  warning-distance: 2
  # Duration of warning effect in seconds
  warning-time: 3

Role-Based Permissions

permissions:
  # Default permissions granted per role
  # Owner implicitly has ALL permissions
  CO_OWNER:
    - BUILD
    - BREAK
    - INTERACT
    - MANAGE
    - SETTINGS
  MEMBER:
    - BUILD
    - BREAK
    - INTERACT

Additional Major Sections

  • Teleportation: Configure delay times and offline visit permissions

  • Cell Points: Enable the points economy and set base earning rates

  • NPCs: Define NPC types, appearances, and egg system parameters

  • Cell Upgrades: Set up different upgrade paths, costs, and progression

  • Storage: Control data saving methods and intervals

  • Display Options: Format currency display and set default notification preferences

  • Cell Chat: Configure chat formatting for members and admin spies

Last updated