Dungeon (functions): Difference between revisions

From PMDOWiki
Imbion (talk | contribs)
3,593 edits
Created page with "{{Cleanup}} == DUNGEON:CharTurnToChar(RogueEssence.Dungeon.Character,RogueEssence.Dungeon.Character) == Makes a character turn to face another === Arguments === * <code>curch</code>: None * <code>turnto</code>: None == DUNGEON:LastDungeonResult == Gets the result of the last dungeon adventure. == DUNGEON:DungeonCurrentFloor == Returns the floor number of the current dungeon. == DUNGEON:DungeonAssetName == Returns the internal name for the current dungeon...."
 
Imbion (talk | contribs)
3,593 edits
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{Cleanup}}
{{Hat Note|More functions: [[Script Reference]]''}}
== DUNGEON:CharTurnToChar(RogueEssence.Dungeon.Character,RogueEssence.Dungeon.Character) ==
 
 
Makes a character turn to face another


The dungeon functions involve actions that are performed within [[dungeon|dungeons]].
== CharTurnToChar==
Makes a character turn to face another.


=== Arguments ===
=== Arguments ===
Argument order is <code>DUNGEON:CharTurnToChar(curch, turnto)</code>.


* <code>curch</code>: None
{| class="wikitable"
* <code>turnto</code>: None
|-
 
! Name !! Type !! Technical Type !! Purpose
== DUNGEON:LastDungeonResult ==
|-
 
| curch || Dungeon Character ||RogueEssence.Dungeon.Character || The character that will turn.
 
|-
Gets the result of the last dungeon adventure.
| turnto || Dungeon Character ||RogueEssence.Dungeon.Character || The character being turned to.
 
|-
 
|}
== DUNGEON:DungeonCurrentFloor ==
 
 
Returns the floor number of the current dungeon.
 


== DUNGEON:DungeonAssetName ==
== LastDungeonResult ==


Gets the result of the last dungeon adventure. Takes no arguments.


Returns the internal name for the current dungeon.
=== Usage ===
{{sectStub}}


== DungeonCurrentFloor ==


== DUNGEON:DungeonDisplayName ==
Returns the floor number of the current dungeon. Takes no arguments.


=== Usage ===
{{sectStub}}


Returns the localized name of the current dungeon.
== DungeonAssetName ==
Returns the internal name for the current dungeon. Takes no arguments.
=== Usage ===
{{sectStub}}


== DungeonDisplayName ==


== DUNGEON:CharSetEmote(RogueEssence.Dungeon.Character,System.String,System.Int32) ==
Returns the localized name of the current dungeon. Takes no arguments.


=== Usage ===


Set a character's emote in a dungeon map.
== CharSetEmote ==


Set a character's emote in a dungeon map. Argument order is <code>DUNGEON:CharSetEmote(chara, emoteID, cycles)</code>.


=== Arguments ===
=== Arguments ===
{| class="wikitable"
|-
! Name !! Type !! Technical Type !! Purpose
|-
| chara || Dungeon Character ||RogueEssence.Dungeon.Character || Character to emote
|-
| emoteID || String || System.String ||  ID of the emote
|-
| emoteID || Integer || System.Int32|| The number of times to play the emote.
|-
|}


* <code>chara</code>: Character to emote
== CharStartAnim ==
* <code>emoteid</code>: ID of the emote
* <code>cycles</code>: The number of times to play the emote.
 
== DUNGEON:CharStartAnim ==
 
 
Set a character's animation.


Set a character's animation. Argument order is <code>DUNGEON:CharStartAnim(chara, emoteID, doLoop)</code>


=== Arguments ===
=== Arguments ===
 
{| class="wikitable"
* <code>chara</code>: Character to animate
|-
* <code>anim</code>: Name of the animation
! Name !! Type !! Technical Type !! Purpose
* <code>loop</code>: Whether to loop the animation
|-
| chara || Dungeon Character ||RogueEssence.Dungeon.Character || Character to animate
|-
| emoteID || String || System.String || Name of the animation
|-
| doLoop || Boolean || System.Bool||  Whether to loop the animation
|-
|}


=== Example ===
=== Example ===
Line 67: Line 85:
</pre>
</pre>


== DUNGEON:CharEndAnim ==
== CharEndAnim ==
 
 
Stops a character's current animation, reverting them to default idle.


Stops a character's current animation, reverting them to default idle. Usage is <code>DUNGEON:CharEndAnim(chara)</code>.


=== Arguments ===
=== Arguments ===
 
{| class="wikitable"
* <code>chara</code>: Character to stop animating
|-
! Name !! Type !! Technical Type !! Purpose
|-
| chara || Dungeon Character ||RogueEssence.Dungeon.Character || Character to stop animating
|-
|}


=== Example ===
=== Example ===
Line 85: Line 106:
</pre>
</pre>


== DUNGEON:CharWaitAnim ==
== CharWaitAnim ==
 
 
Set a character's animation, and waits until it completed before continue.


Set a character's animation, and waits until it completed before continue. Usage is <code>CharWaitAnim(chara, anim)</code>.


=== Arguments ===
=== Arguments ===
 
{| class="wikitable"
* <code>chara</code>: Character to animate
{{ArgHeader}}
* <code>anim</code>: Name of the animation
{{ArgRow
|name=chara
|type=Character
|techt=-
|purp=The character to animate.
}}
{{ArgRow
|name=anim
|type=String
|techt=-
|purp=The string name of the animation.
}}
|}


=== Example ===
=== Example ===
Line 104: Line 135:
</pre>
</pre>


== DUNGEON:PlayVFX(RogueEssence.Content.FiniteEmitter,System.Int32,System.Int32,RogueElements.Dir8) ==
== PlayVFX ==
 
 
Plays a VFX in the dungeon map


Plays a VFX in the dungeon map. Usage is <code>DUNGEON:PlayVFX(emitter, x, y, dir)</code>.


=== Arguments ===
=== Arguments ===
{| class="wikitable"
{{ArgHeader}}
{{ArgRow
|name=emitter
|type=Emitter
|techt=RogueEssence.Content.FiniteEmitter
|purp=The VFX emitter
}}
{{ArgRow
|name=X
|type=Integer
|techt=System.Int32
|purp=X Position in pixels
}}
{{ArgRow
|name=Y
|type=Integer
|techt=System.Int32
|purp=Y Position in pixels
}}
{{ArgRow
|name=dir
|type=Direction
|techt=RogueElements.Dir8
|purp=Direction to orient the VFX, defaults to Down
}}
|}


* <code>emitter</code>: The VFX emitter
== PlayVFX ==
* <code>x</code>: X position in pixels
* <code>y</code>: Y Position in pixels
* <code>dir</code>: Direction to orient the VFX, defaults to Down
 
== DUNGEON:PlayVFX(RogueEssence.Content.FiniteEmitter,System.Int32,System.Int32,RogueElements.Dir8,System.Int32,System.Int32) ==
 
 
Plays a VFX that has a start position and an end position.  It uses a finite emitter that generates BaseAnims.


Plays a VFX that has a start position and an end position.  It uses a finite emitter that generates BaseAnims. {{FuncUsage|nmspace=DUNGEON|nm=PlayVFX|args=emitter, x, y, dir, xTo, yTo}}


=== Arguments ===
=== Arguments ===
{| class="wikitable"
{{ArgHeader}}
{{ArgRow
|name=emitter
|type=Emitter
|techt=RogueEssence.Content.FiniteEmitter
|purp=The VFX emitter
}}
{{ArgRow
|name=x
|type=Integer
|techt=System.Int32
|purp=Start X position in pixels
}}
{{ArgRow
|name=y
|type=Integer
|techt=System.Int32
|purp=Start Y Position in pixels
}}
{{ArgRow
|name=dir
|type=Direction
|techt=RogueElements.Dir8
|purp=Direction to orient the VFX, defaults to Down.
}}
{{ArgRow
|name=xTo
|type=Integer
|techt=System.Int32
|purp=End X position in pixels
}}
{{ArgRow
|name=yTo
|type=Integer
|techt=System.Int32
|purp=End Y Position in pixels
}}
|}


* <code>emitter</code>: The VFX emitter
== PlayVFXAnim ==
* <code>x</code>: Start X position in pixels
* <code>y</code>: Start Y Position in pixels
* <code>dir</code>: Direction to orient the VFX, defaults to Down.
* <code>xTo</code>: End X position in pixels
* <code>yTo</code>: End Y position in pixels
 
== DUNGEON:PlayVFXAnim(RogueEssence.Content.BaseAnim,RogueEssence.Content.DrawLayer) ==
 
 
Plays a VFX using just a BaseAnim


Plays a VFX using just a BaseAnim. {{FuncUsage|nmspace=DUNGEON|nm=PlayVFXAnim|args=anim, layer}}


=== Arguments ===
=== Arguments ===
{| class="wikitable"
{{ArgHeader}}
{{ArgRow
|name=anim
|type=Animation
|techt=RogueEssence.Content.BaseAnim
|purp=The animation to play.
}}
{{ArgRow
|name=layer
|type=Layer
|techt=RogueEssence.Content.DrawLayer
|purp=The layer to draw.
}}
|}


* <code>anim</code>: The animation to play
== MoveScreen ==
* <code>layer</code>: The layer to put it on
 
== DUNGEON:MoveScreen(RogueEssence.Content.ScreenMover) ==
 
 
Plays a screen-moving effect.


Plays a screen-moving effect. {{FuncUsage|nmspace=DUNGEON|nm=MoveScreen|args=mover}}


=== Arguments ===
=== Arguments ===


* <code>mover</code>: The screen mover.
{| class="wikitable"
{{ArgHeader}}
{{ArgRow
|name=mover
|type=Screen Mover
|techt=DUNGEON:MoveScreen(RogueEssence.Content.ScreenMover)
|purp=The screen mover.
}}
|}

Latest revision as of 19:56, 18 January 2026

More functions: Script Reference

The dungeon functions involve actions that are performed within dungeons.

CharTurnToChar

Makes a character turn to face another.

Arguments

Argument order is DUNGEON:CharTurnToChar(curch, turnto).

Name Type Technical Type Purpose
curch Dungeon Character RogueEssence.Dungeon.Character The character that will turn.
turnto Dungeon Character RogueEssence.Dungeon.Character The character being turned to.

LastDungeonResult

Gets the result of the last dungeon adventure. Takes no arguments.

Usage

This section is a stub. You can help PMDO Wiki by expanding it.


DungeonCurrentFloor

Returns the floor number of the current dungeon. Takes no arguments.

Usage

This section is a stub. You can help PMDO Wiki by expanding it.


DungeonAssetName

Returns the internal name for the current dungeon. Takes no arguments.

Usage

This section is a stub. You can help PMDO Wiki by expanding it.


DungeonDisplayName

Returns the localized name of the current dungeon. Takes no arguments.

Usage

CharSetEmote

Set a character's emote in a dungeon map. Argument order is DUNGEON:CharSetEmote(chara, emoteID, cycles).

Arguments

Name Type Technical Type Purpose
chara Dungeon Character RogueEssence.Dungeon.Character Character to emote
emoteID String System.String ID of the emote
emoteID Integer System.Int32 The number of times to play the emote.

CharStartAnim

Set a character's animation. Argument order is DUNGEON:CharStartAnim(chara, emoteID, doLoop)

Arguments

Name Type Technical Type Purpose
chara Dungeon Character RogueEssence.Dungeon.Character Character to animate
emoteID String System.String Name of the animation
doLoop Boolean System.Bool Whether to loop the animation

Example


DUNGEON:CharStartAnim(player, anim, false)

CharEndAnim

Stops a character's current animation, reverting them to default idle. Usage is DUNGEON:CharEndAnim(chara).

Arguments

Name Type Technical Type Purpose
chara Dungeon Character RogueEssence.Dungeon.Character Character to stop animating

Example


DUNGEON:CharEndAnim(player)

CharWaitAnim

Set a character's animation, and waits until it completed before continue. Usage is CharWaitAnim(chara, anim).

Arguments

Name Type Technical Type Purpose
chara Character - The character to animate.
anim String - The string name of the animation.

Example


DUNGEON:CharStartAnim(player, anim)

PlayVFX

Plays a VFX in the dungeon map. Usage is DUNGEON:PlayVFX(emitter, x, y, dir).

Arguments

Name Type Technical Type Purpose
emitter Emitter RogueEssence.Content.FiniteEmitter The VFX emitter
X Integer System.Int32 X Position in pixels
Y Integer System.Int32 Y Position in pixels
dir Direction RogueElements.Dir8 Direction to orient the VFX, defaults to Down

PlayVFX

Plays a VFX that has a start position and an end position. It uses a finite emitter that generates BaseAnims. Argument order is DUNGEON:PlayVFX(emitter, x, y, dir, xTo, yTo).

Arguments

Name Type Technical Type Purpose
emitter Emitter RogueEssence.Content.FiniteEmitter The VFX emitter
x Integer System.Int32 Start X position in pixels
y Integer System.Int32 Start Y Position in pixels
dir Direction RogueElements.Dir8 Direction to orient the VFX, defaults to Down.
xTo Integer System.Int32 End X position in pixels
yTo Integer System.Int32 End Y Position in pixels

PlayVFXAnim

Plays a VFX using just a BaseAnim. Argument order is DUNGEON:PlayVFXAnim(anim, layer).

Arguments

Name Type Technical Type Purpose
anim Animation RogueEssence.Content.BaseAnim The animation to play.
layer Layer RogueEssence.Content.DrawLayer The layer to draw.

MoveScreen

Plays a screen-moving effect. Argument order is DUNGEON:MoveScreen(mover).

Arguments

Name Type Technical Type Purpose
mover Screen Mover DUNGEON:MoveScreen(RogueEssence.Content.ScreenMover) The screen mover.
Retrieved from "https://wiki.pmdo.pmdcollab.org/wiki/index.php?title=Dungeon_(functions)&oldid=6489"