Cinematics¶

HTSkyBlock includes a cinematic camera system for creating immersive orbit camera sequences around locations. Use this to create intro sequences for new players or showcase builds.

Overview¶

Cinematics are camera sequences that: - Orbit around specific locations - Transition smoothly between multiple points - Display custom text at each location - Support post-processing effects (bloom, sunshafts) - Can be triggered on player first join

Base Command¶

/htskyblock cinematic - Cinematic management commands

Permission: htskyblock.admin.cinematic

Cinematic Workflow¶

Create a new cinematic
Select it for editing
Add locations by standing at points of interest
Configure camera settings (orbit speed, radius, height, etc.)
Add text to display at each location
Preview the cinematic
Configure as first-join cinematic (optional)

Cinematic Management¶

create¶

Create a new cinematic for the current world.

Usage: /htskyblock cinematic create <name>

Permission: htskyblock.admin.cinematic.create

Example:

/htskyblock cinematic create spawn_intro

The cinematic is automatically created for the world you're currently in and selected for editing.

delete¶

Delete a cinematic permanently.

Usage: /htskyblock cinematic delete <name>

Permission: htskyblock.admin.cinematic.delete

Example:

/htskyblock cinematic delete old_intro

select¶

Select a cinematic for editing. All subsequent location and settings commands apply to the selected cinematic.

Usage: /htskyblock cinematic select <name>

Permission: htskyblock.admin.cinematic.select

Example:

/htskyblock cinematic select spawn_intro

listall¶

List all cinematics with their configuration details.

Usage: /htskyblock cinematic listall

Permission: htskyblock.admin.cinematic.list

Displays: - All cinematic names - World names - Location counts - Which is selected for editing - Which is set as default first-join cinematic

setworld¶

Change the world associated with a cinematic.

Usage: /htskyblock cinematic setworld <worldname>

Permission: htskyblock.admin.cinematic.setworld

Special Value: - here - Use your current world

Example:

/htskyblock cinematic setworld world_spawn
/htskyblock cinematic setworld here

Location Management¶

setlocation¶

Save your current position as a cinematic location.

Usage: /htskyblock cinematic setlocation <name>

Permission: htskyblock.admin.cinematic.setlocation

Steps: 1. Select a cinematic: /htskyblock cinematic select my_cinematic 2. Stand at the point of interest 3. Run: /htskyblock cinematic setlocation castle_view 4. Repeat for each location in your sequence

Example:

# Select cinematic
/htskyblock cinematic select spawn_intro

# Add locations
/htskyblock cinematic setlocation fountain
/htskyblock cinematic setlocation market
/htskyblock cinematic setlocation castle

Location Order

Locations are played in the order they are created. Plan your camera path accordingly.

removeloc¶

Remove a location from the selected cinematic.

Usage: /htskyblock cinematic removeloc <name>

Permission: htskyblock.admin.cinematic.remove

Example:

/htskyblock cinematic removeloc old_location

list¶

List all locations in the selected cinematic with their details.

Usage: /htskyblock cinematic list

Permission: htskyblock.admin.cinematic.list

Displays: - Order number - Location name - Coordinates (x, y, z) - World name - Dwell time (how long camera stays there)

Camera Settings¶

set¶

Configure camera and timing properties for the cinematic or specific locations.

Usage: /htskyblock cinematic set <property> <value> [location]

Permission: htskyblock.admin.cinematic.set

Properties¶

Property	Scope	Description	Default
`speed`	Cinematic or Location	Orbit speed in degrees per tick	0.5
`radius`	Cinematic or Location	Orbit radius in blocks	5.0
`height`	Cinematic or Location	Camera height above target	2.0
`pitch`	Cinematic or Location	Camera pitch angle (negative = down)	-20.0
`transition`	Cinematic only	Time to move between locations (seconds)	3.0
`dwell`	Location only	Time to stay at location (seconds)	5.0

Setting Cinematic Defaults¶

These apply to all locations unless overridden:

/htskyblock cinematic set speed 0.8
/htskyblock cinematic set radius 8
/htskyblock cinematic set height 3
/htskyblock cinematic set pitch -15
/htskyblock cinematic set transition 5

Setting Per-Location Overrides¶

Override settings for a specific location:

# Make castle view orbit slower and farther
/htskyblock cinematic set speed 0.3 castle_view
/htskyblock cinematic set radius 12 castle_view

# Make fountain stay longer
/htskyblock cinematic set dwell 8 fountain

Cinematic vs Location Settings

Set cinematic defaults first for consistent behavior
Override specific locations to emphasize important areas
Transition time is always cinematic-wide
Dwell time is always location-specific

Display Text¶

settext¶

Add a line of text to display when the camera reaches a location.

Usage: /htskyblock cinematic settext <location> "<text>"

Permission: htskyblock.admin.cinematic.settext

Examples:

/htskyblock cinematic settext fountain "Welcome to SkyBlock Server!"
/htskyblock cinematic settext market "Visit the market to buy and sell items"
/htskyblock cinematic settext castle "The castle protects our realm"

Features: - Add multiple lines by calling the command multiple times - Text displays in order added - Supports color codes in language file - Use quotes for multi-word text

Multi-Line Text

Call settext multiple times for the same location to add multiple lines:

/htskyblock cinematic settext spawn "Welcome to Our Server!"
/htskyblock cinematic settext spawn "Explore, build, and thrive!"
/htskyblock cinematic settext spawn "Type /help to get started"

cleartext¶

Remove all text from a location.

Usage: /htskyblock cinematic cleartext <location>

Permission: htskyblock.admin.cinematic.cleartext

Example:

/htskyblock cinematic cleartext fountain

Preview & Control¶

preview¶

Preview the selected cinematic or a specific cinematic by name.

Usage: /htskyblock cinematic preview [name]

Permission: htskyblock.admin.cinematic.preview

Examples:

# Preview selected cinematic
/htskyblock cinematic preview

# Preview specific cinematic
/htskyblock cinematic preview spawn_intro

# Use "selected" keyword
/htskyblock cinematic preview selected

What Happens: - Camera sequence starts immediately - You cannot move during the cinematic - Text displays at each location - Automatically ends when sequence completes - Use /htskyblock cinematic stop to exit early

stop¶

Stop the currently playing cinematic and return control.

Usage: /htskyblock cinematic stop

Permission: htskyblock.admin.cinematic.stop

First-Join Configuration¶

setfirstjoin¶

Display information about configuring cinematics for new players.

Usage: /htskyblock cinematic setfirstjoin

Permission: htskyblock.admin.cinematic.setfirstjoin

This command displays current first-join settings from config.json.

To configure a cinematic for first-join:

Create and configure your cinematic
Edit config.json:

{
  "cinematic": {
    "enabled": true,
    "showToNewPlayers": true,
    "defaultCinematic": "spawn_intro"
  }
}

Reload: /htskyblock reload

Configuration Options:

Option	Description
`enabled`	Master switch for cinematics system
`showToNewPlayers`	Auto-play for new players on first join
`defaultCinematic`	Name of cinematic to play on first join

First Join Trigger

The cinematic only plays once per player. If you want to reset this for testing, delete the player's entry in player_data.json or use a new test account.

Post-Processing Effects¶

Cinematics support visual effects configured in config.json:

{
  "cinematic": {
    "bloom": {
      "enabled": true,
      "intensity": 1.0
    },
    "sunshafts": {
      "enabled": true,
      "intensity": 0.8
    }
  }
}

Effects: - Bloom - Glowing light effect around bright areas - Sunshafts - God rays from sun/sky

Adjust intensity values between 0.0 (off) and 2.0 (maximum).

Complete Example¶

Here's a complete workflow for creating a spawn intro cinematic:

# 1. Create the cinematic
/htskyblock cinematic create spawn_intro

# 2. Add locations (walk to each spot first)
/htskyblock cinematic setlocation fountain
/htskyblock cinematic setlocation market
/htskyblock cinematic setlocation castle
/htskyblock cinematic setlocation spawn_platform

# 3. Configure cinematic-wide settings
/htskyblock cinematic set speed 0.6
/htskyblock cinematic set radius 6
/htskyblock cinematic set height 2.5
/htskyblock cinematic set pitch -18
/htskyblock cinematic set transition 4

# 4. Set location-specific dwell times
/htskyblock cinematic set dwell 6 fountain
/htskyblock cinematic set dwell 5 market
/htskyblock cinematic set dwell 7 castle
/htskyblock cinematic set dwell 4 spawn_platform

# 5. Add text to each location
/htskyblock cinematic settext fountain "Welcome to SkyBlock Paradise!"
/htskyblock cinematic settext market "Trade with other players here"
/htskyblock cinematic settext castle "Our mighty fortress"
/htskyblock cinematic settext spawn_platform "Your adventure begins"

# 6. Preview it
/htskyblock cinematic preview

# 7. If satisfied, set as first-join cinematic
# Edit config.json: "defaultCinematic": "spawn_intro"
# Then: /htskyblock reload

Troubleshooting¶

Cinematic Not Playing¶

Check config.json: cinematic.enabled must be true
Run /htskyblock reload after config changes
Ensure cinematic has at least one location
Verify you're in the correct world

Camera Path Issues¶

Use /htskyblock cinematic list to check location order
Adjust transition time if camera moves too fast/slow
Increase radius if camera clips through blocks
Adjust height if camera is underground/sky

Text Not Displaying¶

Check that text was added with settext
Use /htskyblock cinematic list to verify text is set
Ensure text is in quotes: settext location "Text here"

Performance Issues¶

Reduce orbit speed for smoother motion
Increase transition time for less jarring movement
Disable post-processing effects in config
Reduce number of locations in sequence

Permission Summary¶

Command	Permission
Base	`htskyblock.admin.cinematic`
All subcommands	`htskyblock.admin.cinematic.*`

Individual permissions: - htskyblock.admin.cinematic.create - htskyblock.admin.cinematic.delete - htskyblock.admin.cinematic.select - htskyblock.admin.cinematic.setworld - htskyblock.admin.cinematic.setfirstjoin - htskyblock.admin.cinematic.list - htskyblock.admin.cinematic.setlocation - htskyblock.admin.cinematic.remove - htskyblock.admin.cinematic.preview - htskyblock.admin.cinematic.stop - htskyblock.admin.cinematic.set - htskyblock.admin.cinematic.settext - htskyblock.admin.cinematic.cleartext