Guide Avancé


Gestion du Cube

Création

Introduction

Avec iceTok, chaque cube est lié à un joueur. Cela signifie que vous seul pouvez interagir avec votre propre cube. Les dimensions indiquées incluent les bordures du cube.

Commande de base : /it-fillbox-create VOTRENOM TAILLEX TAILLEY TAILLEZ.

Exemples

Suppression

Introduction

Vous pouvez supprimer votre cube à tout moment si vous souhaitez le recréer. Attention, cette action est irréversible et toutes les personnalisations seront définitivement perdues. Toutefois, si besoin, vous pouvez récupérer les données du cube dans le fichier suivant : plugins/iceTok/fillbox/VOTREUUID.yml.

Commande de base : /it-fillbox-delete VOTRENOM.

Gestion de la Roulette

Roulette

Introduction

iceTok intègre une roulette dynamique entièrement personnalisable, offrant une infinité de configurations possibles. Vous pouvez également appliquer un multiplicateur spécifique à chaque élément de la roulette. Par défaut, la roulette intègre 3 configurations, wheel-sample, wheel-score-multiplier et wheel-score et gère automatiquement une file d'attente en cas d'appels multiples.

Commande de base : /it-fillbox-wheel VOTRENOM CONFIGURATION.

Exemples

Personnalisation

Introduction

Vous pouvez ajouter des configurations (Au format JSON, voir l'exemple ci-dessous) personnalisées pour vos roulettes dans le répertoire plugins/iceTok/fillbox/wheels/NOMDELACONFIGURATION.json.

{
  "wheel": [
	{
	  "name": "-1 WIN",
	  "type": "SCORE",
	  "count": 5,
	  "probability": 0.50,
	  "style": {
	    "background-color": "#D14545",
	    "text-color": "#FFFFFF",
	    "text-border-color": "#B23B3B",
	    "text-border-size": 3
	  },
	  "data": {
	    "count": 1,
	    "action": "remove",
	    "type": "game",
	    "multiplier": false,
	    "force": false
	  }
	},
	{
	  "name": "-2 WIN",
	  "type": "SCORE",
	  "count": 3,
	  "probability": 0.30,
	  "style": {
	    "background-color": "#D14545",
	    "text-color": "#FFFFFF",
	    "text-border-color": "#B23B3B",
	    "text-border-size": 3
	  },
	  "data": {
	    "count": 2,
	    "action": "remove",
	    "type": "game",
	    "multiplier": false,
	    "force": false
	  }
	},
	{
	  "name": "-3 WIN",
	  "type": "SCORE",
	  "count": 1,
	  "probability": 0.15,
	  "style": {
	    "background-color": "#D14545",
	    "text-color": "#FFFFFF",
	    "text-border-color": "#B23B3B",
	    "text-border-size": 3
	  },
	  "data": {
	    "count": 3,
	    "action": "remove",
	    "type": "game",
	    "multiplier": false,
	    "force": false
	  }
	},
	{
	  "name": "+1 WIN",
	  "type": "SCORE",
	  "count": 5,
	  "probability": 0.50,
	  "style": {
	    "background-color": "#8DD145",
	    "text-color": "#FFFFFF",
	    "text-border-color": "#78B23B",
	    "text-border-size": 3
	  },
	  "data": {
	    "count": 1,
	    "action": "add",
	    "type": "game",
	    "multiplier": false,
	    "force": false
	  }
	},
	{
	  "name": "+2 WIN",
	  "type": "SCORE",
	  "count": 3,
	  "probability": 0.30,
	  "style": {
	    "background-color": "#8DD145",
	    "text-color": "#FFFFFF",
	    "text-border-color": "#78B23B",
	    "text-border-size": 3
	  },
	  "data": {
	    "count": 2,
	    "action": "add",
	    "type": "game",
	    "multiplier": false,
	    "force": false
	  }
	},
	{
	  "name": "+3 WIN",
	  "type": "SCORE",
	  "count": 1,
	  "probability": 0.15,
	  "style": {
	    "background-color": "#8DD145",
	    "text-color": "#FFFFFF",
	    "text-border-color": "#78B23B",
	    "text-border-size": 3
	  },
	  "data": {
	    "count": 3,
	    "action": "add",
	    "type": "game",
	    "multiplier": false,
	    "force": false
	  }
	},
    {
      "name": "X2",
      "type": "MULTIPLIER",
      "count": 2,
      "probability": 0.25,
      "style": {
        "background-color": "#D17546",
        "text-color": "#FFFFFF",
        "text-border-color": "#B2633C",
        "text-border-size": 3
      },
      "data": {
        "count": 2,
        "action": "add",
        "duration": "3m"
      }
    },
    {
      "name": "X10",
      "type": "MULTIPLIER",
      "count": 1,
      "probability": 0.25,
      "style": {
        "background-color": "#D17546",
        "text-color": "#FFFFFF",
        "text-border-color": "#B2633C",
        "text-border-size": 3
      },
      "data": {
        "count": 10,
        "action": "add",
        "duration": "3m"
      }
    },
    {
      "name": "128 TNT",
      "type": "TNT",
      "count": 3,
      "probability": 0.15,
      "style": {
        "background-color": "#46D1A3",
        "text-color": "#FFFFFF",
        "text-border-color": "#3CB28B",
        "text-border-size": 3
      },
      "data": {
        "count": 128,
        "target": "player",
        "power": 2.0,
        "random": false,
        "multiplier": false
      }
    },
    {
      "name": "256 TNT",
      "type": "TNT",
      "count": 3,
      "probability": 0.15,
      "style": {
        "background-color": "#46D1A3",
        "text-color": "#FFFFFF",
        "text-border-color": "#3CB28B",
        "text-border-size": 3
      },
      "data": {
        "count": 256,
        "target": "player",
        "power": 2.0,
        "random": false,
        "multiplier": false
      }
    },
    {
      "name": "Défi",
      "type": "CUSTOM",
      "count": 3,
      "probability": 0.1,
      "style": {
        "background-color": "#D146D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#B23CB2",
        "text-border-size": 3
      },
      "data": {}
    },
    {
      "name": "RESET",
      "type": "UNFILL",
      "count": 1,
      "probability": 0.15,
      "style": {
        "background-color": "#D1D146",
        "text-color": "#FFFFFF",
        "text-border-color": "#B2B23C",
        "text-border-size": 3
      },
      "data": {
        "count": 10,
        "type": "floor",
        "speed": "5t",
        "multiplier": false
      }
    },
    {
      "name": "REMPLIR",
      "type": "FILL",
      "count": 1,
      "probability": 0.15,
      "style": {
        "background-color": "#D1D146",
        "text-color": "#FFFFFF",
        "text-border-color": "#B2B23C",
        "text-border-size": 3
      },
      "data": {
        "count": 10,
        "type": "floor",
        "speed": "5t",
        "multiplier": false
      }
    },
    {
      "name": "+3 BLOCS",
      "type": "FILL",
      "count": 1,
      "probability": 0.15,
      "style": {
        "background-color": "#D1D146",
        "text-color": "#FFFFFF",
        "text-border-color": "#B2B23C",
        "text-border-size": 3
      },
      "data": {
        "count": 3,
        "type": "block",
        "speed": "5t",
        "multiplier": false
      }
    },
    {
      "name": "-3 BLOCS",
      "type": "UNFILL",
      "count": 1,
      "probability": 0.15,
      "style": {
        "background-color": "#D1D146",
        "text-color": "#FFFFFF",
        "text-border-color": "#B2B23C",
        "text-border-size": 3
      },
      "data": {
        "count": 3,
        "type": "block",
        "speed": "5t",
        "multiplier": false
      }
    },
    {
      "name": "Jetpack",
      "type": "JETPACK",
      "count": 2,
      "probability": 0.1,
      "style": {
        "background-color": "#4675D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#3C63B2",
        "text-border-size": 3
      },
      "data": {
        "duration": "1s",
        "power": 127,
        "multiplier": false
      }
    },
    {
      "name": "Fusée",
      "type": "JETPACK",
      "count": 1,
      "probability": 0.1,
      "style": {
        "background-color": "#4675D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#3C63B2",
        "text-border-size": 3
      },
      "data": {
        "duration": "1s",
        "power": 255,
        "multiplier": false
      }
    },
    {
      "name": "Bouclier +30s",
      "type": "SHIELD",
      "count": 1,
      "probability": 0.1,
      "style": {
        "background-color": "#7546D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#633CB2",
        "text-border-size": 3
      },
      "data": {
        "action": "add",
        "duration": "30s",
        "multiplier": false
      }
    },
    {
      "name": "Prison +60s",
      "type": "JAIL",
      "count": 1,
      "probability": 0.1,
      "style": {
        "background-color": "#4646D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#3C3CB2",
        "text-border-size": 3
      },
      "data": {
        "action": "set",
        "duration": "60s",
        "multiplier": false
      }
    },
    {
      "name": "Prison -60s",
      "type": "JAIL",
      "count": 1,
      "probability": 0.1,
      "style": {
        "background-color": "#4646D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#3C3CB2",
        "text-border-size": 3
      },
      "data": {
        "action": "remove",
        "duration": "60s",
        "multiplier": false
      }
    },
    {
      "name": "Sortie Prison",
      "type": "JAIL",
      "count": 1,
      "probability": 0.1,
      "style": {
        "background-color": "#4646D1",
        "text-color": "#FFFFFF",
        "text-border-color": "#3C3CB2",
        "text-border-size": 3
      },
      "data": {
        "action": "reset"
      }
    }
  ]
}

Gestion de l'Overlay

Overlay

Introduction

Les overlays sont un élément central d’iceTok : ils permettent d’afficher à vos spectateurs votre score, l’état du multiplicateur ainsi que celui de votre bouclier anti-TNT.

Il existe plusieurs overlays

image.png

image.png

Commande de base : /it-fillbox-overlay VOTRENOM TYPE.

Un lien apparaîtra dans la console du serveur (Start.bat alias l’invité de commandes) et copiez-le pour l’intégrer dans TikTok Live Studio en tant que source de type : Lien.

N’effectuez aucun redimensionnement sur l'overlay default car les éléments s’affichent sur une seule ligne (Score, Multiplicateur, Bouclier). Concernant l'overlay wheel, vous devez simuler une roulette pour qu'elle s'affiche à votre écran. Testez et ajustez l'affichage pour qu’ils s’intègrent parfaitement à votre environnement de live.

Aperçus

image.png

image.png

Personnalisation

Actuellement, la personnalisation de l’overlay se limite aux couleurs du fond et du texte.

Vous pouvez ajouter de la transparence à vos couleurs en ajoutant deux chiffres à la fin de la valeur HEX.
Ces deux chiffres doivent être compris entre 00 (Totalement transparent) et 99 (Légèrement transparent).

Commande de base : /it-fillbox-setting VOTRENOM PARAMETRE VALEUR.

Gestion du Remplissage & Réinitialisation

Remplissage & Réinitialisation

Introduction

iceTok intègre plusieurs modes de remplissage et de retrait de blocs à l’intérieur du cube. Le paramètre de vitesse utilisé dans les commandes s’exprime en ticks Minecraft, où 20t correspond à 1 seconde (0t = Immédiat, 10t = 0,5s, 20t = 1s). Le remplissage par étage permet de remplir uniquement les étages vides du cube, en partant du plus bas étage disponible, et non systématiquement depuis la base.

Le mode fill utilise la personnalisation du spectateur (Par défaut, un bloc de béton vert), tandis que customfill se base sur votre propre configuration de blocs, définie selon le niveau de votre cube. En option, vous pouvez appliquer le multiplicateur sur le nombre de blocs générés ou sur le nombre d’étages remplis lors de l’exécution de ces actions.

Commandes de base

Exemples

Gestion des TNT

TNT

Introduction

Avec iceTok, vous pouvez gérer le comportement de la TNT : sa puissance, son nombre, ainsi que son lieu d’apparition (Sur le joueur ou à l’intérieur du cube). Vous avez également la possibilité de rendre ces apparitions aléatoires ou fixes, selon l’effet recherché.

En option, vous pouvez appliquer le multiplicateur à la puissance et au nombre de TNT générées, pour des explosions encore plus spectaculaires. Tous les blocs de Minecraft n'ont pas la même résistance à la TNT. Il est donc recommandé d’adapter la puissance des explosions en fonction des matériaux utilisés dans votre cube.

La puissance de la TNT s’exprime au format décimal flottant, sous la forme X.Xf (Par exemple : 2.5f). Plus la valeur est élevée, plus l’explosion est destructrice.

Exemples de puissances

Commande de base : /it-fillbox-tnt VOTRENOM POSITION NOMBRE PUISSANCE MODEALEATOIRE MODEMULTIPLICATEUR.

Exemples

Gestion du Multiplicateur

Multiplicateur

Introduction

iceTok intègre un multiplicateur dynamique, qui est appliqué automatiquement aux éléments configurés. Il calcule en temps réel les effets sur les actions choisies (Score, TNT, Bouclier, Blocs, Prison, Etc…), vous permettant de personnaliser l’expérience selon l’engagement des spectateurs. Par défaut, la puissance maximale du multiplicateur est limitée à x10.

Le multiplicateur dispose de plusieurs modes : il peut être fixé à une valeur précise, s’additionner à la valeur actuelle ou encore se multiplier avec elle. Chaque fois qu’un spectateur envoie un multiplicateur, la durée de celui-ci s’additionne à la durée en cours, sans limite. Seule la puissance est plafonnée à x10, valeur configurable dans les paramètres.

Commande de base : /it-fillbox-multiplier VOTRENOM ACTION NOMBRE DUREE.

Exemples
Gestion

Les commandes ci-dessous sont des commandes de gestion, vous pouvez les ajouter à vos actions TikFinity comme étant des raccourcis, mais vous ne devez pas les associer à des évènements de live.

Gestion du Bouclier Anti-TNT

Bouclier

Introduction

Avec iceTok, vous pouvez activer un bouclier anti-TNT pour protéger temporairement votre cube des explosions. Vous avez la possibilité d’appliquer le multiplicateur pour faire varier la durée selon l’engagement des spectateurs. Par défaut, la durée maximale de ce bouclier est limitée à une minute. À chaque fois qu’un spectateur envoie un bouclier, la durée s’additionne à la protection en cours, toujours dans la limite des 60 secondes configurées par défaut.

Commande de base : /it-fillbox-shield VOTRENOM DUREE MODEMULTIPLICATEUR.

Exemples

Gestion du Score

Score

Introduction

iceTok intègre un système de gestion automatique du score, chaque ajout ou retrait est calculé en temps réel en fonction des actions effectuées dans le cube ou par les spectateurs. Vous avez également la possibilité d’appliquer le multiplicateur au score, pour augmenter le score en fonction de l’interaction des spectateurs.

Commande de base : /it-fillbox-score VOTRENOM ACTION NOMBRE MODEMULTIPLICATEUR FORCER.

Exemples
Gestion

Les commandes ci-dessous sont des commandes de gestion, vous pouvez les ajouter à vos actions TikFinity comme étant des raccourcis, mais vous ne devez pas les associer à des évènements de live.

Gestion de la Prison

Prison

Introduction

iceTok intègre une prison statique permettant aux spectateurs d’emprisonner temporairement le joueur afin de l’empêcher de jouer. Il est possible d’ajouter ou de retirer du temps, ou encore de répéter l’action plusieurs fois, la durée sera automatiquement cumulée, dans la limite définie dans la configuration (Par défaut : 5 minutes). Vous pouvez appliquer le multiplicateur à la durée d’emprisonnement, selon vos préférences.

Commande de base : /it-fillbox-jail VOTRENOM ACTION DUREE MODEMULTIPLIEUR.

Exemples
Aperçus

image.png

image.png