Field
These are the attribute values pertaining to players.
The player’s nickname (name), location (tileX / tileY), etc. can be viewed. The player’s spotlight (spotlight) feature and hide (hidden) feature can be activated. The player’s movement speed (moveSpeed) and image (sprite) can be adjusted. It’s also possible to utilize the Space's storage (storage) for storing player values.
🔒 Fields with this icon are read-only fields that cannot be revised.
Name | Description |
|---|---|
🔒 id | Player ID value |
name | Player Nickname value |
title | Text to be displayed in yellow above an avatar’s nickname |
🔒 role | A numerical value that represents a player’s permissions |
🔒 tileX / tileY | The X and Y coordinate values where the avatar is standing |
🔒 dir | A value representing the direction a player is looking |
moveSpeed | A value representing the player’s movement speed |
sprite | An avatar’s sprite image value |
tag | Value storage space to assign required attribute values |
hidden | If the value is set to true, the player is invisible |
spotlight | Toggle player spotlight |
🔒 disableVideo | Toggle player video |
🔒 disableAudio | Toggle player audio |
attackType | Player’s attack type when z is pressed |
attackSprite | Player’s attack image value when z is pressed |
attackParam1 | Distance value that affects how far the attack image flies |
attackParam2 | Distance value available for attack
Only valid when attackType is set to 2 (ranged attack) |
🔒 walletAddress | The player’s wallet address value |
storage | Storage space for player values in the Space (limited to the Space) |
🔒 isMobile | Whether the player is connected via mobile |
🔒 isMoving | If the player is moving, returns True. If not, returns False |
🔒 isJumping | If the player is jumping, returns True. If not, returns False |
customData | Can read the URL query string and save the value |
displayRatio | Zoom in or out player's display |
titleColor | Player's title color |
🔒 emailHash | The hash value of the player's email |
🔒 isGuest | If the player is not signed in, returns True. |
player.id: Number
player.name: String
Calls the player ID and nickname values.
Example
Make the player’s ID and nickname value display when a player enters.
// Activates function when a player enters
App.onJoinPlayer.Add(function(player){
App.sayToAll(`id: ${player.id} name: ${player.name}`);
})
player.title: String
Title is a yellow text that displays above the avatar’s nickname.
Example
Set up a title for a player when they enter.
// Activates function when a player enters
App.onJoinPlayer.Add(function(player){
player.title = "title";
player.sendUpdated();
})
player.role: Number
Role is the player’s permission roles’ number value.
The following values will be displayed depending on the player’s role.
Role | Number | Role | Number |
|---|---|---|---|
Guest | -1 | Staff | 2000 |
Member | 0 | Admin | 3000 |
Editor | 1000 | Owner | 3001 |
Example
Display the permission role value in the chat screen.
// Activates function when q is pressed
// **[App.addOnKeyDown Description (Link)](https://www.notion.so/Callbacks-7ac5078bab7c4f3180ae05463713581d)**
App.addOnKeyDown(81,function(player){
App.sayToAll(`${player.name}'s permissions: ${player.role}`)
})
player.tileX: Number
player.tileY: Number
The x axis value and y axis value of where the player’s avatar is standing.
Example
Display my avatar’s x and y coordinates.
// Activates function when q is pressed
// **[App.addOnKeyDown Description (Link)](https://www.notion.so/Callbacks-7ac5078bab7c4f3180ae05463713581d)**
App.addOnKeyDown(81,function(player){
App.sayToAll(`Current Coordinates: (${player.tileX}, ${player.tileY})`)
})
player.dir: Number
The direction the player’s avatar is looking.
The following values are displayed depending on the direction the avatar is looking.
Direction | Number | Direction | Number |
|---|---|---|---|
Left | 1 | Top-Left | 5 |
Up | 2 | Bottom-Left | 6 |
Right | 3 | Top-Right | 7 |
Down | 4 | Bottom-Right | 8 |
Example
Display the value of where the avatar is looking.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81,function(player){
App.sayToAll(`Direction the avatar is looking: ${player.dir}`)
})
player.moveSpeed: Number
This is the player’s movement speed value. (Default Value: 80)
If the movement speed value is 0, the player cannot move.
Example
Increase the movement speed when q is pressed.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81,function(player){
player.moveSpeed = 150;
player.sendUpdated();
})
player.sprite: ScriptDynamicResource
A sprite image of the player’s avatar. (Resets to the default avatar image when inputting null)
Example
Apply the Paintman-Blueman image as the avatar image.
예제_loadSpritesheet.zip
29KB
Binary
// One frame's size 48x64
let blueman = App.loadSpritesheet('blueman.png', 48, 64, {
left: [5, 6, 7, 8, 9], // left direction facing image
up: [15, 16, 17, 18, 19],
down: [0, 1, 2, 3, 4],
right: [10, 11, 12, 13, 14],
dance: [20,21,22,23,24,25,26,27,28,29,30,31,32,33,34,35,36,37],
down_jump: [38],
left_jump: [39],
right_jump: [40],
up_jump: [41],
}, 8);
// Changes avatar's image when player enters
App.onJoinPlayer.Add(function(player){
player.sprite = blueman;
player.sendUpdated();
});
player.tag: Any
Give necessary attribute values to a player by using tag.
Example
Give a player the ‘alive’ attribute value. The ‘alive’ attribute value is a deliberately created attribute.
If the attribute is unused, it won’t be a useful attribute value. In this case, the "alive" attribute value can check if a player has been eliminated from a game or not.
// Activates function when a player enters
App.onJoinPlayer.Add(function (player) {
player.tag = {
alive: true,
};
player.sendUpdated();
App.sayToAll(`alive: ${player.tag.alive}`);
});
player.hidden: Boolean
If the hidden attribute value is true, the corresponding player is not visible to other players.
The avatar in a hidden state is not visible, but it is possible to connect the video and audio.
Example
Give an avatar the hidden attribute to make the avatar not visible to other players.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81,function(player){
player.hidden = true;
player.sendUpdated();
});
player.spotlight: Boolean
This activates or deactivates the player’s spotlight feature.
Example
Make a function that turns the spotlight feature ON or OFF by pressing q.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81,function(player){
if(player.spotlight){
player.spotlight = false;
}
else{
player.spotlight = true;
}
player.sendUpdated();
});
player.disableVideo: Boolean
player.disableAudio: Boolean
This activates or deactivates the player’s video/audio features.
Example
Display in the chat screen if the video and/or audio are deactivated or not.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81, function (player) {
App.sayToAll(`video activation or deactivation: ${player.disableVideo}`);
App.sayToAll(`audio activation or deactivation: ${player.disableAudio}`);
});
player.attackType: Number
This is a player’s attack type performed by pressing z. (default value: 0)
attackType | Description |
|---|---|
0 | If the attackType is not set up, it means it is set to the default attack type. |
Example
Change the avatar’s attackType.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81, function (player) {
player.attackType = 0;
App.sayToAll(`attackType: ${player.attackType}`);
player.sendUpdated();
});
player.attackParam1: Number
This is an attribute for the attack image’s distance range shown when pressing z. The attack’s possible distance range does not increase.
Example
Change the attackParam1.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81, function (player) {
App.sayToAll(`attackType: ${player.attackType}`);
App.sayToAll(`attackParam1: ${player.attackParam1}`);
player.attackType = 0;
player.attackParam1 = 10;
player.sendUpdated();
});
player.attackParam2: Number
This is an attribute for distance available for attack. This is only valid when attackType is set to a ranged attack.
Example
Set a ranged attack using attackParam2.
// Activates function when q is pressed
// App.addOnKeyDown
App.addOnKeyDown(81, function (player) {
player.attackType = 2;
player.attackParam2 = 5;
App.sayToAll(`attackType: ${player.attackType}`);
App.sayToAll(`attackParam2: ${player.attackParam2}`);
player.sendUpdated();
});
player.attackSprite: ScriptDynamicResource
This is an attribute for the attack image shown when pressing z.
Example
Apply the boxing game’s glove attack image.
let redBoxing = App.loadSpritesheet("redBoxing.png");
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81, function (player) {
player.attackSprite = redBoxing;
player.sendUpdated();
});
player.walletAddress: String
This is the player’s wallet address.
Example
Call the wallet address. If there is no wallet address, the results called will be null.
// Activates function when q is pressed
// **[App.addOnKeyDown Description (Link)](https://www.notion.so/Callbacks-7ac5078bab7c4f3180ae05463713581d)**
App.addOnKeyDown(81, function (player) {
App.sayToAll(`${player.walletAddress}`)
});
player.storage: String
This is the storage space for the player value within the space. (Limited to the Space)
Example
Store the data in player storage and check it.
Even after closing the app and restarting it, the stored values will not disappear.
// Activates function when q is pressed
// App.addOnKeyDown Description
App.addOnKeyDown(81,function(player){
player.storage = "data";
player.save(); // Applies the changed storage value to player.save() when storage values are changed
})
// Activates function when w is pressed
App.addOnKeyDown(87,function(player){
App.sayToAll(player.storage); // Displays the value saved in player storage on the chat screen
})
player.isMobile : Boolean
This displays whether the player is connected via mobile in true or false.
Example
Display mobile PC status in the entry message when a player enters.
// Activates function when a player enters
App.onJoinPlayer.Add(function(player){
if(player.isMobile){
App.sayToAll(`${player.name} entered from mobile.`)
} else{
App.sayToAll(`${player.name} entered from PC.`)
}
});
player.isMoving : Boolean
If the player is moving, this function returns True. If not, this returns False.
Example
Detect the player's movement and display a message.
App.onUpdate.Add(function (dt) {
let _players = App.players;
for (let i in _players) {
let p = _players[i];
if (p.isMoving) {
App.sayToAll(`${p.name} is moving...`);
}
}
});
player.isJumping : Boolean
If the player is jumping, this function returns True. If not, this returns False.
Example
Detect the player's movement and display a message.
App.onUpdate.Add(function (dt) {
let _players = App.players;
for (let i in _players) {
let p = _players[i];
if (p.isJumping) {
App.sayToAll(`[System] ${p.name} is jumping...`);
}
}
});
player.customData : String
This field saves the value received as a query string.
Example
player.displayRatio
This function zooms the player's display in or out. (Default Value: 1)
Example
Create a key to zoom in or out.
// Activates function when Q is pressed
// Press once to zoom in and press again to zoom out
App.addOnKeyDown(81,function(player){
if(player.displayRatio == 1){
player.displayRatio = 5;
}else{
player.displayRatio = 1;
}
player.sendUpdated(); //* When the player's field value is updated, apply it as player.sendUpdated()
})
displayRatio = 1
displayRatio = 5
player.titleColor
This function can read and change the player title's color.
You can enter enum values or hex code values.
Available Enum ColorType
{ WHITE, BLACK, RED, GREEN, BLUE, ORANGE, PURPLE, GRAY, YELLOW, MAGENTA, CYAN }
Example
Change the title color.
// Activates function when Q is pressed
App.addOnKeyDown(81, function (player) {
player.title = "🔸Title🔸";
// When enum values are entered
player.titleColor = ColorType.CYAN;
// When hex codes are entered (Delete "//" when using the following)
// player.titleColor = 0x00FFFF;
player.sendUpdated(); //*When the player's field value is updated, apply it as player.sendUpdated()
});
player.emailHash
This function reads the hash value of the player's email.
Example
Display the hash value of a player.
// Activates function when a player enters
App.onJoinPlayer.Add(function(player){
App.sayToAll(`name: ${player.name} emailHash: ${player.emailHash}`);
})
player.isGuest
If the player is not signed in, this function returns True.
Example
Show "GUEST" as a title when a guest who is not signed in enters.
// Activates function when a player enters
App.onJoinPlayer.Add(function(player){
if(player.isGuest){
player.title = "GUEST";
player.sendUpdated();
}
})
Last modified 7mo ago