-
Notifications
You must be signed in to change notification settings - Fork 2
Core Concepts
AxDevv edited this page Nov 29, 2025
·
1 revision
Forms are the visual representation system in BBS. They define how entities, morphs, and model blocks appear.
| Type | Description |
|---|---|
model |
Custom 3D models (OBJ, BOBJ, VOX, Cubic) |
mob |
Vanilla mob appearances |
block |
Block as a form |
item |
Item as a form |
billboard |
2D sprite facing the camera |
label |
Text display |
particle |
Particle effects |
extruded |
Extruded 2D textures |
anchor |
Reference point |
trail |
Motion trails |
framebuffer |
Screen capture display |
- Transforms: Position, rotation, scale (base/overlay/first-person/third-person)
- Hitbox: Custom collision box
- Body Parts: Attachable sub-forms
- Animation States: Triggered animations
A Film is a complete cinematic project containing:
- Camera Clips: Camera movements and effects
- Replays: Recorded player performances
- Snapshots: Inventory, HP, XP states
Films are stored as compressed .dat files in <world>/bbs/films/.
| Clip Type | Description |
|---|---|
idle |
Static camera position |
dolly |
Linear movement between points |
path |
Curved path through multiple points |
keyframe |
Keyframe-based animation |
Modifiers alter camera behavior:
| Modifier | Effect |
|---|---|
translate |
Offset position |
angle |
Adjust rotation |
drag |
Smooth following |
shake |
Camera shake effect |
math |
Mathematical expressions |
look |
Look at target |
orbit |
Orbit around point |
remapper |
Time remapping |
tracker |
Track entity |
dolly_zoom |
Vertigo effect |
| Type | Purpose |
|---|---|
audio |
Play sound |
subtitle |
Display text |
curve |
Animation curve |
A Replay stores:
- Keyframes: Position, rotation, slots, armor, flags per tick
- Properties: Shadow, looping, relative offsets
- Action Clips: Gameplay events
| Action | Description |
|---|---|
chat |
Send chat message |
command |
Execute command |
place_block |
Place a block |
break_block |
Break a block |
interact_block |
Interact with block |
use_item |
Use held item |
drop_item |
Drop item |
attack |
Attack entity |
damage |
Receive damage |
swipe |
Arm swing |
Damage Control restores world state after playback:
- Blocks broken during replay are restored
- Entities killed are respawned
- Enable via settings or
/bbs dc start
Renders any Form as a block in the world.
- Supports per-view transforms
- Multiple visual variants
- Animation state triggers
8 solid color blocks for green-screen compositing.
Configurable projectile weapons with:
| Property | Description |
|---|---|
scatter |
Spread pattern |
speed |
Projectile velocity |
gravity |
Gravity effect |
bounce |
Bounce count |
damage |
Hit damage |
knockback |
Push force |
impact |
Impact command/form |
zoom |
Zoom form/command |
projectile |
Custom projectile form |
Players can morph into any Form:
- Applies visual appearance
- Modifies attributes (speed, health, etc.)
- Plays form animation states
- Use
/bbs morphor pressBfor the panel