Comment on page
🧮 Variables
Since SCore variable placeholders are supported by PlaceholderAPI, you can use the SCore variables like this:
%math_{score_variables_userLevel}*10%
Score has a integration of variables where you can store strings/numbers in variables in a global way or per player, they aren't integrated in EI or EB, but they are integrated as commands (so they can be used in combination with EI / EB)
They are stored in
plugins/Score/variables
Type | Explanation |
---|---|
GLOBAL | Variable stored in a global way, that means, if this variable is parsed with one player it will get the same value as it would be parsed with another player. |
PLAYER | Variable stored for each player, that means, the value is different per player, so parsing this variable with one player can have a different value with another player |
Type | Explanation |
---|---|
SET | You set a static value to the variable |
MODIFICATION | You modify the variable (useful for INT variables, to add value to a integer value, or to substract a certain value) |
- /score variables list
- /score variables info {var_name} [player]
- /score variables-create {var_name}
- /score variables-delete {var_name}
- /score variables
- /score variables clear {typeofvariable} {nameofvariable} [player]
/score variables <typeofmodification> <typeofvariable> <nameofvariable> <value> [player]
- Examples:
- GLOBAL Variables:
- /score variables SET GLOBAL thisisthenameofthevariable 100
- /score variables MODIFICATION GLOBAL thisisthenameofthevariable 100
- PLAYER Variables
- /score variables SET PLAYER myvariable -50 Ssomar
- /score variables MODIFICATION PLAYER myvariable -50 Ssomar
This requires PlaceholderAPI.
- %score_variables_<var_name>%
- %score_variables_<var_name>_int%
Name of the variables can't have underscores -> "
If you want to set a variable a value with spaces, such as value: "This is my variable", we suggest you to:
1) Don't use spaces, just write "_" instead of " " so the variable name would be "This_is_my_variable"
2) If you really need the spaces you can use the Formatter extension of PlaceholderAPI to remove certain letters, for example:
%formatter_text_replace_*_ _{score_variables_ThisIsTheNameOfMyVariable}%
Normally %score_variables_ThisIsTheNameOfMyVariable% would return HELLO_THERE, but with the Formatter placeholder the result is HELLO THERE .
This is a type of variable that is quite complex and have its own features, that's why it is separated, let's explain it
- Create a variable
- /score variables-create ThisIsTheNameOfMyVariable
- Add values into the list
- /score variables list-add PLAYER ThisIsTheNameOfMyVariable TEXT1 Ssomar
- /score variables list-add PLAYER ThisIsTheNameOfMyVariable TEXT2 Ssomar
- To specify a place to add the value into the list use index feature
- /score variables list-add PLAYER ThisIsTheNameOfMyVariable TEXT3 Ssomar index:0
- To see the modification
- /score variables info ThisIsTheNameOfMyVariable
- Removing values:
- Remove the last value
- /score variables list-remove PLAYER ThisIsTheNameOfMyVariable Ssomar
- Remove a specific index
- /score variables list-remove PLAYER ThisIsTheNameOfMyVariable Ssomar index:0
- Remove a specific value
- /score variables list-remove PLAYER ThisIsTheNameOfMyVariable Ssomar value:Test
Variable-list also work with GLOBAL variables, but you would need to change instead of PLAYER -> GLOBAL and remove the player in the command
Placeholder | Text |
---|---|
%score_variables_<variable-name>_<index>% | Return the value at the specific index of the list |
%score_variables_<variable-name>% | returns all the elements of the list |
%score_variables-contains_<variable-name>_<value>% | Boolean to see if the list contains a value (true or false) |
%score_variables-size_<variable-name>% | Returns the size of the list |
What you can do with this feature -> Item created by Ssomar
name: '&6&l>> &7Terminator stick &6&l<<'
lore:
- '&7Select entites by right'
- '&7clicking on them !'
- '&eLimit: &63 entities'
- '&e'
- '&7Then shift + right click'
- '&7to make them explode !'
material: STICK
glow: false
disableStack: false
keepItemOnDeath: false
canBeUsedOnlyByTheOwner: false
storeItemInfo: false
unbreakable: false
usage: 1
usageLimit: -1
cancelEventIfNoPerm: false
cancelEventIfNotOwner: false
disabledWorlds: []
recognitions: []
config_5: true
config_update: true
dropOptions:
glowDrop: false
glowDropColor: WHITE
displayNameDrop: false
hiders:
hideEnchantments: false
hideUnbreakable: false
hideAttributes: false
hidePotionEffects: false
hideUsage: true
hideDye: false
enchantments: {}
giveFirstJoin:
giveFirstJoin: false
giveFirstJoinAmount: 1
giveFirstJoinSlot: 0
restrictions: {}
variables: {}
activators:
activator0:
name: '&eActivator'
option: PLAYER_RIGHT_CLICK
typeTarget: NO_TYPE_TARGET
usageModification: 0
cancelEvent: false
noActivatorRunIfTheEventIsCancelled: false
silenceOutput: false
autoUpdateItem: false
updateName: true
updateLore: true
updateDurability: false
updateAttributes: false
updateEnchants: false
updateCustomModelData: false
cooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
globalCooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
otherEICooldowns: {}
requiredItems: {}
requiredExecutableItems: {}
detailedSlots:
- -1
commands:
- SWING_MAIN_HAND
- LAUNCH DEFAULT_INVISIBLE_ARROW_NO_GRAVITY_SPEED
playerConditions: {}
worldConditions: {}
itemConditions: {}
customConditions: {}
placeholdersConditions: {}
variablesModification: {}
activator5:
name: '&eActivator'
option: PROJECTILE_HIT_ENTITY
usageModification: 0
cancelEvent: false
noActivatorRunIfTheEventIsCancelled: false
silenceOutput: false
autoUpdateItem: false
updateName: true
updateLore: true
updateDurability: false
updateAttributes: false
updateEnchants: false
updateCustomModelData: false
cooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
globalCooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
otherEICooldowns: {}
requiredItems: {}
requiredExecutableItems: {}
detailedSlots:
- -1
commands:
- 'SENDMESSAGE &7You &cunselected &7the entity: &e%entity_name%'
- score variables list-remove player myList %player% value:%entity_uuid%
playerConditions: {}
worldConditions: {}
itemConditions: {}
customConditions: {}
placeholdersConditions:
plchCdt0:
type: PLAYER_STRING
comparator: EQUALS
part1: '%score_variables-contains_myList_%entity_uuid%%'
part2: 'true'
cancelEventIfNotValid: false
messageIfNotValid: ''
messageIfNotValidForTarget: ''
detailedEntities: []
entityCommands: []
entityConditions: {}
variablesModification: {}
activator2:
name: '&eActivator'
option: PLAYER_LEFT_CLICK
typeTarget: NO_TYPE_TARGET
usageModification: 0
cancelEvent: false
noActivatorRunIfTheEventIsCancelled: false
silenceOutput: false
autoUpdateItem: false
updateName: true
updateLore: true
updateDurability: false
updateAttributes: false
updateEnchants: false
updateCustomModelData: false
cooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
globalCooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
otherEICooldowns: {}
requiredItems: {}
requiredExecutableItems: {}
detailedSlots:
- -1
commands:
- execute at %score_variables_myList_0% run summon minecraft:tnt ~ ~ ~
- execute at %score_variables_myList_1% run summon minecraft:tnt ~ ~ ~
- execute at %score_variables_myList_2% run summon minecraft:tnt ~ ~ ~
- score variables clear player myList %player%
- SENDMESSAGE &7Then it's just a big &eBOOOOOM &7but you can do many other things
let's talk your imagination
playerConditions:
ifSneaking: true
ifSneakingMsg: ''
worldConditions: {}
itemConditions: {}
customConditions: {}
placeholdersConditions: {}
variablesModification: {}
activator1:
name: '&eActivator'
option: PROJECTILE_HIT_ENTITY
usageModification: 0
cancelEvent: false
noActivatorRunIfTheEventIsCancelled: false
silenceOutput: false
autoUpdateItem: false
updateName: true
updateLore: true
updateDurability: false
updateAttributes: false
updateEnchants: false
updateCustomModelData: false
cooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
globalCooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
otherEICooldowns: {}
requiredItems: {}
requiredExecutableItems: {}
detailedSlots:
- -1
commands:
- 'SENDMESSAGE &7You &aselected &7the entity: &e%entity_name%'
- score variables list-add player myList %entity_uuid% %player%
playerConditions: {}
worldConditions: {}
itemConditions: {}
customConditions: {}
placeholdersConditions:
plchCdt0:
type: PLAYER_STRING
comparator: EQUALS
part1: '%score_variables-contains_myList_%entity_uuid%%'
part2: 'false'
cancelEventIfNotValid: false
messageIfNotValid: ''
messageIfNotValidForTarget: ''
plchCdt1:
type: PLAYER_NUMBER
comparator: INFERIOR
part1: '%score_variables-size_myList%'
part2: '3'
cancelEventIfNotValid: false
messageIfNotValid: '&4&l>> &7&oYou can''t select more than 3 entities'
messageIfNotValidForTarget: ''
detailedEntities: []
entityCommands: []
entityConditions: {}
variablesModification: {}
activator3:
name: cancelProjectileSelection
option: PROJECTILE_HIT_ENTITY
usageModification: 0
cancelEvent: true
noActivatorRunIfTheEventIsCancelled: false
silenceOutput: false
autoUpdateItem: false
updateName: true
updateLore: true
updateDurability: false
updateAttributes: false
updateEnchants: false
updateCustomModelData: false
cooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
globalCooldownOptions:
cooldown: 0
isCooldownInTicks: false
cooldownMsg: '&cYou are in cooldown ! &7(&e%time_H%&6H &e%time_M%&6M &e%time_S%&6S&7)'
displayCooldownMessage: true
cancelEventIfInCooldown: false
otherEICooldowns: {}
requiredItems: {}
requiredExecutableItems: {}
detailedSlots:
- -1
commands: []
playerConditions: {}
worldConditions: {}
itemConditions: {}
customConditions: {}
placeholdersConditions: {}
detailedEntities: []
entityCommands: []
entityConditions: {}
variablesModification: {}
attributes: {}
ExecutableItems has a integration of variables where you can store strings/numbers/list in variables inside the item. With them you can create multiple mechanics in your items.
ExecutableBlocks has a integration of variables where you can store strings/numbers/list in variables inside the block. With them you can create multiple mechanics in your blocks.