WorldCannon Configuration

WorldCannon wa hitotsu no global config file to, cannon goto ni hitotsu no config file o tsukaimasu.

File Layout

• Global config: plugins/FunRTP/config.yml
• Per-cannon configs: plugins/FunRTP/custom/fun_rtps/<id>.yml

Plugin ni wa example_world_cannon to iu namae no example cannon package mo fukumarete imasu. Kore wa default de wa disabled desu.

Global Config Structure

Main config wa tsugi no bunrui no shita ni seiri sarete imasu:

• runtime.*
• landing.*
• messages.*
• protection.*

Runtime Settings

Key	Default	Behavior
runtime.scanIntervalTicks	10	Cannon ga chikaku no player o check suru hindo
runtime.particleIntervalTicks	15	Idle cannon particle ga hyoji sareru hindo

Landing Search Settings

Key	Default	Behavior
landing.searchAttemptsPerTick	2	Preload chuu ni, tick goto ni cannon hitori atari nan-kai search suru ka
landing.preloadedLocationsPerCannon	5	Plugin ga queue ni iji shiyou to suru anzen na destination no kazu
landing.searchTimeoutSeconds	1000	Mada search chuu no cannon ga exhausted to handan sareru made no jikan
landing.slowFallingSeconds	60	Touchaku-go no Slow Falling jikan (player ga chakuchi suru to effect wa hayame ni sakujo saremasu)
landing.failOpenOnProtectionErrors	false	Protection API error ji wa default de landing o block suru

Landing Sounds

Tsugi no sound key wa settei dekimasu:

• landing.sounds.levitationStart.sound
• landing.sounds.levitationStart.volume
• landing.sounds.levitationStart.pitch
• landing.sounds.blastOff.sound
• landing.sounds.blastOff.volume
• landing.sounds.blastOff.pitch

Default sound wa warmup ni BLOCK_BEACON_ACTIVATE, blast-off ni ENTITY_GENERIC_EXPLODE desu.

Unsafe Material Lists

WorldCannon wa futatsu no material list ni motozuite kouho no landing spot o kyohi shimasu:

• landing.unsafeGroundMaterials
• landing.unsafeBodyMaterials

Default unsafe ground materials:

• LAVA
• MAGMA_BLOCK
• CAMPFIRE
• SOUL_CAMPFIRE
• CACTUS
• POWDER_SNOW

Default unsafe body materials:

• LAVA
• WATER
• FIRE
• SOUL_FIRE
• SWEET_BERRY_BUSH
• POWDER_SNOW
• COBWEB

Message Settings

Plugin wa tsugi no shita de message key to title key o teikyou shimasu:

• messages.prefix
• messages.helpHeader
• messages.createdCannon
• messages.deletedCannon
• messages.movedCannon
• messages.targetWorldUpdated
• messages.searchCenterUpdated
• messages.reload
• messages.noPermission
• messages.cannonDisabled
• messages.queueCalibration
• messages.noValidLocationYet
• messages.noValidLocationFound
• messages.invalidConfiguration
• messages.statusLine
• messages.probeAllowed
• messages.probeBlocked
• messages.unknownCommand
• messages.titles.launchQueuedTitle
• messages.titles.launchQueuedSubtitle
• messages.titles.destinationPreviewTitle
• messages.titles.destinationPreviewSubtitle
• messages.titles.destinationConfirmedTitle
• messages.titles.destinationConfirmedSubtitle
• messages.titles.arrivalSubtitles

Title key wa jidou launch to arrival message o seigyo shimasu. arrivalSubtitles wa list de, plugin wa launch goto ni random ni hitotsu no gyou o erabimasu. Genzai no implementation ni wa manual confirmation prompt wa arimasen.

Cannon Goto no Config Field

Kaku cannon file wa tsugi no field o hoji shimasu:

Field	Default	Notes
isEnabled	Atarashiku sakusei shita cannon de wa true	Disabled cannon wa trigger shimasen
displayName	Underscore o kuuhaku ni kaeta sanitize zumi id	Message to status output de tsukawaremasu
cannonLocation	Hitsuyou	Cannon no trigger ga aru basho
targetWorld	Sakusei ji no genzai world	Runtime de loaded sarete iru hitsuyou ga arimasu
searchCenter	Sakusei ji no genzai world no spawn	Ato de unset ni nattara, plugin wa target world no spawn ni fallback shimasu
triggerRadius	1.75	Chikaku no player o kenshutsu suru tame no radius
minSearchRadius	500	Search center kara no minimum landing search kyori
maxSearchRadius	5000	Search center kara no maximum landing search kyori
launchWarmupSeconds	6	Launch mae no levitation/countdown jikan
verticalBoostTicks	45	Teleport mae ni upward velocity ga kakerareru tick suu
verticalBoostVelocity	1.35	Launch chuu ni tekiyou sareru upward velocity
enableParticles	true	Idle cannon particle o seigyo shimasu
requiredPermission	blank	Sono cannon no tame no opushon no tsuika permission gate

Cannon Sakusei Ji no Default

/wc create o jikkou suru to:

• cannon id wa lower-case ni sare, a-z, 0-9, _, - igai no moji wa _ ni okikaeraremasu
• display name wa sanitize sareta id no _ o kuuhaku ni kaeta mono ga default ni narimasu
• cannonLocation wa genzai no position ni settei saremasu
• targetWorld wa genzai no world ni settei saremasu
• searchCenter wa sono world no spawn ni settei saremasu

Runtime Validation no Behavior

WorldCannon wa tsugi no check no doreka ga shippai suru to, kouho no landing location o kyohi shimasu:

• target world ga unloaded
• search center ga invalid
• random sample ga world border no soto ni ochiru
• safe na solid surface ga mitsukaranai
• feet matawa head no space ga fusagatte iru
• terrain matawa body block ga settei sareta unsafe material list ni match suru
• protection integration ga landing o block suru

Moshi cannon ga landing.searchTimeoutSeconds made ni yuukou na location o mitsukerarenai baai, sono cannon wa exhausted ni nari, player o launch suru kawari ni settei sareta failure message o kaeshimasu.