Home

Welcome to the fb wiki.

fb is an open-source 2D MMORPG game server project. This wiki documents server design, development setup, and Lua scripting.

About the project

• High-performance: Designed for scalability and real-time gameplay
• Microservices architecture: Separate components for gateway, login, game, internal services, and write-back operations
• Cross-platform: Supports Windows and Linux for development and production deployment
• Comprehensive testing: Bot testing framework for load testing and integration testing
• Lua scripting: Flexible game logic through Lua scripts (see Builtin functions)
• Cloud deployment: Docker Compose (single host) and Kubernetes; optional Pulumi for cluster IaC

Server

• Architecture
• Technology Stack
• Map Division
• Thread Model

Setup

• Windows installation
  • Windows — Runner
  • Windows — Build from source
• Linux installation
  • Linux — Docker Compose
  • Linux — Kubernetes
  • Linux — Pulumi (optional)

Scripting

• Builtin functions