Wiki Let's Role - Contributions [fr]

System Builder

2025-09-10T21:54:10Z

Guile :

The System Builder is a tool for creating game systems for the [https://lets-role.com/ Let's Roll] gaming tables. It allows for the comprehensive construction of various essential tools such as player character sheets, as well as the creation of non-player character sheets, objects, and game monitoring tools for Game Masters.

The tool is accessible to anyone with a Let's Roll account. It is designed so that anyone can develop their own system without any coding knowledge. The System Builder is equipped with coding tools (pseudoJS) that allow for the creation of complex, non-essential functionalities that will add a bit of convenience.

=== First step ===
Quickstart video guide for creating systems in Let’s Role (🇫🇷 ''French only)''

https://www.youtube.com/watch?v=F141URrFVwo
[[Fichier:Video_thumbnail_Start_on_SB.png|néant|vignette]]

==== Interface ====
Inserez l'image de l'interface

# The title of the edited system
# [Create new views], navigate between [views]...
# The list of [[components|c]]<nowiki/>[[components|omponents]] usable for building a view
# [The dependency tree of views]
# Launch the system on a table to [test the system]
# The tabs [view], [table], [script], [translation], the tools to develop a system
# The [preview of the sheet]
# The buttons [save], [deploy], and [exit]
# The panel of the selected [component parameters]

===== Views =====
Views are trees of components. They can be instantiated by the [tab] component or the [repeater] component to create complex and well-organized sheets.

==== Creating a New View ====
To create a new view, click on the "Create a new view" button. Fill in the popup with an ID (no capital letters, no special characters, no numbers, and use underscores to separate words), for example: "vue_armes". To switch views, use the dropdown list.

==== Building a View ====
To build a view, use the components in window 3 by dragging and dropping them into the component tree of the view in window 4.

===== Layout Components =====
Layout components are used to structure and organize components among themselves, such as rows, columns, and containers.

TODO: Link to a tutorial

===== Form Components =====
Form components are designed to contain the information for your character sheet.

===== Container Components =====
Containers are components that can contain views to create complete and dynamic sheets.

=== Special Components ===
Special components allow you to perform specific and essential actions for a character sheet.

==== Tables ====
Tables are spreadsheets that allow you to provide information for certain components, such as lists, tabs, etc.

==== Script ====
The script is a JS file that allows you to perform more complete and complex actions than managing views alone.

[[FirstScript|Your first step in the script]]

=== Tutorials ===

#[[Styling character sheets with classes|Build character sheets with Bootstrap]]
# [[Put a dice roll result in the sheet]]
# [[Use lists]]
# [[Use tabs]]
# [[Use repeaters]]
# [[Show or hide components]]
# [[Progress bar]]
# [https://lets-role.com/help/fr/documentation/v1/component/avatar Configure the avatar properly]

FirstScript

2025-09-10T21:52:44Z

Guile : Page créée avec « === Introduction === Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules. You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences. === Step 0 : basics === Here are a list of empiric rules that will help you writing your script : * make it readable and understandabl... »

=== Introduction ===
Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules.

You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences.

=== Step 0 : basics ===
Here are a list of empiric rules that will help you writing your script :

* make it readable and understandable : use appropriate names, indent your code (format your code automaticaly with <code>SHIFT+ALT+F</code>)
* structure, separate your rules
* don't repeat yourself (DRY) : there are many ways to make your code readable and not repetitive. Remind one rule : if you copy / paste some code in your script, it could good to generalise it.
* Don't hesitate to ask the community for help

=== Step 1 : init ===
Every script must have a <code>init</code> function. This function will be called as soon as a sheet is opened (character sheet, token sheet, craft sheet, prompt sheet). We use the <code>init</code> to add some interactivity and complex rules on the sheet.

As it is a unique function to handle many different sheets, you must use an <code>if</code> to check which init code to execute on which sheet.

Here is a simple example that we recommend to use only if you plan to keep the very simple script.
init = function (sheet) {
if (sheet.id() === "main") {
// write you code here for the sheet with the id "main"
}
}
If you want to make some inits for few other sheets, we recommend to create different function. The following solution is a very clean way to handle the initialisation of different sheets using their id to detect them. Creating different function helps you to separate the rules of your system. The more your script will grow, the more you'll need to organize it.
init = function (sheet) {
const sheetId = sheet.id()
if (sheetId === "main") {
initMain(sheet)
} else if (sheetId === "monster") {
initMonster(sheet)
} else if (sheetId === "object") {
initObject(sheet)
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
As the number of pages increases, you will quickly see that you are repeating yourself by adding a long list of <code>if else if</code>, to prevent that you can check this [[Init Advanced Tip|advanced script tip for init]].

{{CLEFDETRI:FirstScript}}

FristScript

2025-09-10T21:52:21Z

Guile :

FristScript

2025-09-10T21:51:35Z

Guile :

{{DISPLAYTITLE:First Script}}
{{DISPLAYTITLE:FirstScript}}

=== Introduction ===
Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules.

You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences.

=== Step 0 : basics ===
Here are a list of empiric rules that will help you writing your script :

* make it readable and understandable : use appropriate names, indent your code (format your code automaticaly with <code>SHIFT+ALT+F</code>)
* structure, separate your rules
* don't repeat yourself (DRY) : there are many ways to make your code readable and not repetitive. Remind one rule : if you copy / paste some code in your script, it could good to generalise it.
* Don't hesitate to ask the community for help

=== Step 1 : init ===
Every script must have a <code>init</code> function. This function will be called as soon as a sheet is opened (character sheet, token sheet, craft sheet, prompt sheet). We use the <code>init</code> to add some interactivity and complex rules on the sheet.

As it is a unique function to handle many different sheets, you must use an <code>if</code> to check which init code to execute on which sheet.

Here is a simple example that we recommend to use only if you plan to keep the very simple script.
init = function (sheet) {
if (sheet.id() === "main") {
// write you code here for the sheet with the id "main"
}
}
If you want to make some inits for few other sheets, we recommend to create different function. The following solution is a very clean way to handle the initialisation of different sheets using their id to detect them. Creating different function helps you to separate the rules of your system. The more your script will grow, the more you'll need to organize it.
init = function (sheet) {
const sheetId = sheet.id()
if (sheetId === "main") {
initMain(sheet)
} else if (sheetId === "monster") {
initMonster(sheet)
} else if (sheetId === "object") {
initObject(sheet)
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
As the number of pages increases, you will quickly see that you are repeating yourself by adding a long list of <code>if else if</code>, to prevent that you can check this [[Init Advanced Tip|advanced script tip for init]].

{{CLEFDETRI:FirstScript}}

FristScript

2025-09-10T21:51:02Z

Guile :

{{DISPLAYTITLE:FirstScript}}

=== Introduction ===
Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules.

You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences.

=== Step 0 : basics ===
Here are a list of empiric rules that will help you writing your script :

* make it readable and understandable : use appropriate names, indent your code (format your code automaticaly with <code>SHIFT+ALT+F</code>)
* structure, separate your rules
* don't repeat yourself (DRY) : there are many ways to make your code readable and not repetitive. Remind one rule : if you copy / paste some code in your script, it could good to generalise it.
* Don't hesitate to ask the community for help

=== Step 1 : init ===
Every script must have a <code>init</code> function. This function will be called as soon as a sheet is opened (character sheet, token sheet, craft sheet, prompt sheet). We use the <code>init</code> to add some interactivity and complex rules on the sheet.

As it is a unique function to handle many different sheets, you must use an <code>if</code> to check which init code to execute on which sheet.

Here is a simple example that we recommend to use only if you plan to keep the very simple script.
init = function (sheet) {
if (sheet.id() === "main") {
// write you code here for the sheet with the id "main"
}
}
If you want to make some inits for few other sheets, we recommend to create different function. The following solution is a very clean way to handle the initialisation of different sheets using their id to detect them. Creating different function helps you to separate the rules of your system. The more your script will grow, the more you'll need to organize it.
init = function (sheet) {
const sheetId = sheet.id()
if (sheetId === "main") {
initMain(sheet)
} else if (sheetId === "monster") {
initMonster(sheet)
} else if (sheetId === "object") {
initObject(sheet)
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
As the number of pages increases, you will quickly see that you are repeating yourself by adding a long list of <code>if else if</code>, to prevent that you can check this [[Init Advanced Tip|advanced script tip for init]].

{{CLEFDETRI:FirstScript}}

FristScript

2025-09-01T16:06:29Z

Guile :

Init Advanced Tip

2025-09-01T14:58:10Z

Guile : Page créée avec « As soon as you have a large number of different sheet to initialize (more than 10), we recommend to use more advanced code to make it shorter. It uses a list of initializers associated with the sheet id. This will prevent you to write a large and repetitive list of <code>if else if</code>. The following code shows one way to do it. // A list of initializers, associating the sheet id with an init function const initializers = { main: initMain, monster:... »

As soon as you have a large number of different sheet to initialize (more than 10), we recommend to use more advanced code to make it shorter. It uses a list of initializers associated with the sheet id. This will prevent you to write a large and repetitive list of <code>if else if</code>. The following code shows one way to do it.
// A list of initializers, associating the sheet id with an init function
const initializers = {
main: initMain,
monster: initMonster,
object: initObject,
}

init = function (sheet) {
const sheetId = sheet.id()
if (initializers[sheetId]) {
initializers[sheetId](sheet); // this line will execute the desired initializer.
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
One big pro for this technic is that the init function will not change anymore. If you want to add a new sheet to initialize (e.g., <code>vehicule</code>), you have to create a new function called <code>initVehicule</code> and reference if in <code>initializers</code> (adding a line <code>vehicule: initVehicule</code>).

FristScript

2025-09-01T14:38:21Z

Guile :

=== Introduction ===
Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules.

You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences.

=== Step 0 : basics ===
Here are a list of empiric rules that will help you writing your script :

* make it readable and understandable : use appropriate names, indent your code (format your code automaticaly with <code>SHIFT+ALT+F</code>)
* structure, separate your rules
* don't repeat yourself (DRY) : there are many ways to make your code readable and not repetitive. Remind one rule : if you copy / paste some code in your script, it could good to generalise it.
* Don't hesitate to ask the community for help

=== Step 1 : init ===
Every script must have a <code>init</code> function. This function will be called as soon as a sheet is opened (character sheet, token sheet, craft sheet, prompt sheet). We use the <code>init</code> to add some interactivity and complex rules on the sheet.

As it is a unique function to handle many different sheets, you must use an <code>if</code> to check which init code to execute on which sheet.

Here is a simple example that we recommend to use only if you plan to keep the very simple script.
init = function (sheet) {
if (sheet.id() === "main") {
// write you code here for the sheet with the id "main"
}
}
If you want to make some inits for few other sheets, we recommend to create different function. The following solution is a very clean way to handle the initialisation of different sheets using their id to detect them. Creating different function helps you to separate the rules of your system. The more your script will grow, the more you'll need to organize it.
init = function (sheet) {
const sheetId = sheet.id()
if (sheetId === "main") {
initMain(sheet)
} else if (sheetId === "monster") {
initMonster(sheet)
} else if (sheetId === "object") {
initObject(sheet)
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
As soon as you have a large number of different sheet to initialize (more than 10), we recommend to use more advanced code to make it shorter. It uses a list of initializers associated with the sheet id. This will prevent you to write a large and repetitive list of <code>if else if</code>. The following code shows one way to do it.
// A list of initializers, associating the sheet id with an init function
const initializers = {
main: initMain,
monster: initMonster,
object: initObject,
}

init = function (sheet) {
const sheetId = sheet.id()
if (initializers[sheetId]) {
initializers[sheetId](sheet); // this line will execute the desired initializer.
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
One big pro for this technic is that the init function will not change anymore. If you want to add a new sheet to initialize (e.g., <code>vehicule</code>), you have to create a new function called <code>initVehicule</code> and reference if in <code>initializers</code> (adding a line <code>vehicule: initVehicule</code>).

FristScript

2025-09-01T14:30:53Z

Guile : add shortcut to format code

=== Introduction ===
Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules.

You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences.

=== Step 0 : basics ===
Here are a list of empiric rules that will help you writing your script :

* make it readable and understandable : use appropriate names, indent your code (format your code automaticaly with <code>SHIFT+ALT+F</code>)
* structure, separate your rules
* don't repeat yourself (DRY) : there are many ways to make your code read

=== Step 1 : init ===
Every script must have a <code>init</code> function. This function will be called as soon as a sheet is opened (character sheet, token sheet, craft sheet, prompt sheet). We use the <code>init</code> to add some interactivity and complex rules on the sheet.

As it is a unique function to handle many different sheets, you must use an <code>if</code> to check which init code to execute on which sheet.

Here is a simple example that we recommend to use only if you plan to keep the very simple script.
init = function (sheet) {
if (sheet.id() === "main") {
// write you code here for the sheet with the id "main"
}
}
If you want to make some inits for few other sheets, we recommend to create different function. The following solution is a very clean way to handle the initialisation of different sheets using their id to detect them. Creating different function helps you to separate the rules of your system. The more your script will grow, the more you'll need to organize it.
init = function (sheet) {
const sheetId = sheet.id()
if (sheetId === "main") {
initMain(sheet)
} else if (sheetId === "monster") {
initMonster(sheet)
} else if (sheetId === "object") {
initObject(sheet)
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
As soon as you have a large number of different sheet to initialize (more than 10), we recommend to use more advanced code to make it shorter. It uses a list of initializers associated with the sheet id. This will prevent you to write a large and repetitive list of <code>if else if</code>. The following code shows one way to do it.
// A list of initializers, associating the sheet id with an init function
const initializers = {
main: initMain,
monster: initMonster,
object: initObject,
}

init = function (sheet) {
const sheetId = sheet.id()
if (initializers[sheetId]) {
initializers[sheetId](sheet); // this line will execute the desired initializer.
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
One big pro for this technic is that the init function will not change anymore. If you want to add a new sheet to initialize (e.g., <code>vehicule</code>), you have to create a new function called <code>initVehicule</code> and reference if in <code>initializers</code> (adding a line <code>vehicule: initVehicule</code>).

FristScript

2025-09-01T13:26:11Z

=== Introduction ===
Writing a script while you're not a coder is a very intimidating task : it is a new language with a lot of syntax rules.

You can start reading some tutorials on how to start with javascript. Let's Role allows you to code with a version of JavaScript that is close to the standard, but with a few differences.

=== Step 0 : basics ===
Here are a list of empiric rules that will help you writing your script :

* make it readable and understandable : use appropriate names, indent your code
* structure, separate your rules
* don't repeat yourself (DRY) : there are many ways to make your code read

=== Step 1 : init ===
Every script must have a <code>init</code> function. This function will be called as soon as a sheet is opened (character sheet, token sheet, craft sheet, prompt sheet). We use the <code>init</code> to add some interactivity and complex rules on the sheet.

As it is a unique function to handle many different sheets, you must use an <code>if</code> to check which init code to execute on which sheet.

Here is a simple example that we recommend to use only if you plan to keep the very simple script.
init = function (sheet) {
if (sheet.id() === "main") {
// write you code here for the sheet with the id "main"
}
}
If you want to make some inits for few other sheets, we recommend to create different function. The following solution is a very clean way to handle the initialisation of different sheets using their id to detect them. Creating different function helps you to separate the rules of your system. The more your script will grow, the more you'll need to organize it.
init = function (sheet) {
const sheetId = sheet.id()
if (sheetId === "main") {
initMain(sheet)
} else if (sheetId === "monster") {
initMonster(sheet)
} else if (sheetId === "object") {
initObject(sheet)
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
As soon as you have a large number of different sheet to initialize (more than 10), we recommend to use more advanced code to make it shorter. It uses a list of initializers associated with the sheet id. This will prevent you to write a large and repetitive list of <code>if else if</code>. The following code shows one way to do it.
// A list of initializers, associating the sheet id with an init function
const initializers = {
main: initMain,
monster: initMonster,
object: initObject,
}

init = function (sheet) {
const sheetId = sheet.id()
if (initializers[sheetId]) {
initializers[sheetId](sheet); // this line will execute the desired initializer.
}
}

function initMain(sheet) {
// write you code here for the sheet with the id "main"
}

function initMonster(sheet) {
// write you code here for the sheet with the id "monster"
}

function initObject(sheet) {
// write you code here for the sheet with the id "object"
}
One big pro for this technic is that the init function will not change anymore. If you want to add a new sheet to initialize (e.g., <code>vehicule</code>), you have to create a new function called <code>initVehicule</code> and reference if in <code>initializers</code> (adding a line <code>vehicule: initVehicule</code>).

System Builder

2025-09-01T08:53:31Z

Guile : Add First script link

The System Builder is a tool for creating game systems for the [https://lets-role.com/ Let's Roll] gaming tables. It allows for the comprehensive construction of various essential tools such as player character sheets, as well as the creation of non-player character sheets, objects, and game monitoring tools for Game Masters.

The tool is accessible to anyone with a Let's Roll account. It is designed so that anyone can develop their own system without any coding knowledge. The System Builder is equipped with coding tools (pseudoJS) that allow for the creation of complex, non-essential functionalities that will add a bit of convenience.

=== First step ===
Quickstart video guide for creating systems in Let’s Role (🇫🇷 ''French only)''

https://www.youtube.com/watch?v=F141URrFVwo
[[Fichier:Video_thumbnail_Start_on_SB.png|néant|vignette]]

==== Interface ====
Inserez l'image de l'interface

# The title of the edited system
# [Create new views], navigate between [views]...
# The list of [[components|c]]<nowiki/>[[components|omponents]] usable for building a view
# [The dependency tree of views]
# Launch the system on a table to [test the system]
# The tabs [view], [table], [script], [translation], the tools to develop a system
# The [preview of the sheet]
# The buttons [save], [deploy], and [exit]
# The panel of the selected [component parameters]

===== Views =====
Views are trees of components. They can be instantiated by the [tab] component or the [repeater] component to create complex and well-organized sheets.

==== Creating a New View ====
To create a new view, click on the "Create a new view" button. Fill in the popup with an ID (no capital letters, no special characters, no numbers, and use underscores to separate words), for example: "vue_armes". To switch views, use the dropdown list.

==== Building a View ====
To build a view, use the components in window 3 by dragging and dropping them into the component tree of the view in window 4.

===== Layout Components =====
Layout components are used to structure and organize components among themselves, such as rows, columns, and containers.

TODO: Link to a tutorial

===== Form Components =====
Form components are designed to contain the information for your character sheet.

===== Container Components =====
Containers are components that can contain views to create complete and dynamic sheets.

=== Special Components ===
Special components allow you to perform specific and essential actions for a character sheet.

==== Tables ====
Tables are spreadsheets that allow you to provide information for certain components, such as lists, tabs, etc.

==== Script ====
The script is a JS file that allows you to perform more complete and complex actions than managing views alone.

[[FristScript|Your first step in the script]]

=== Tutorials ===

#[[Styling character sheets with classes|Build character sheets with Bootstrap]]
# [[Put a dice roll result in the sheet]]
# [[Use lists]]
# [[Use tabs]]
# [[Use repeaters]]
# [[Show or hide components]]
# [https://lets-role.com/help/fr/documentation/v1/component/avatar Configure the avatar properly]

Put a dice roll result in the sheet

2025-08-10T09:14:30Z

Guile :

=== Summary ===
In this tutorial, we'll see how to fill a label based on a dice roll result.

You will see that the solution can only be made with some script. Here the solution uses a specific action button in the Dice Result.

=== Step by step ===

# create an element that will trigger the dice roll. Ex: a label with the id <code>labelTriggeringDiceRoll</code>
# create an element that will receive the dice roll result (or anything based on the dice roll). Ex: a label with the id <code>labelReceivingDiceRoll</code>
# in the script, add an click event that rolls the dice you need by using <code>Dice.roll</code>
# <code>Dice.roll</code> accepts a list of action buttons as last parameter. This is an object whose keys are the Button label that will be shown in the Dice log and values are a function that is called when the button is clicked (see the [https://lets-role.com/help/en/documentation/v1/scripting/dice-api Actions section in the Dice API documentation]). The parameter given to the function is a [https://lets-role.com/help/en/documentation/v1/scripting/dice-result Dice Result].
# If correctly defined, the function can have an elegant access to the sheet.
# This access to the sheet is the main way to change the desired label.

=== Final code ===
Here is the code used in the [https://lets-role.com/system/system-builder-demo-16760 System Builder Demo]
const labelToClick = sheet.get("labelTriggeringDiceRoll"); // get the label that will roll dice when clicked
labelToClick.on("click", function () { // handle the click event on the label
const actions = {}; // initiate the list of actions in dice result
actions[_("Apply to sheet")] = function (dice) { // add a translated button label
const labelToFill = sheet.get("labelReceivingDiceRoll"); // when click on the action button, the code can access to the label to change
labelToFill.value("Last roll was " + dice.total); // set anything in the label, based on dice
};
Dice.roll(sheet, "10+1D10", "Roll strength", "all", actions); // Roll the dice
});

=== Live example ===
You can see a live example in the [https://lets-role.com/system/system-builder-demo-16760 System Builder Demo] in the tab "Fill with Dice Result" (you must run a table in order to have dice rolls, the sheet preview block dice rolls)

You can check the code in the function <code>initFillWithRoll</code> that illustrates what is described in this tutorial.

System Builder

2025-05-09T08:19:44Z

Guile : link to video

=== First step ===
Quickstart video guide for creating systems in Let’s Role (🇫🇷 ''French only)''

https://www.youtube.com/watch?v=F141URrFVwo
[[Fichier:Video thumbnail Start on SB.png|néant|vignette]]

=== Tutorials ===
[[Put a dice roll result in the sheet]]

Fichier:Video thumbnail Start on SB.png

2025-05-09T08:14:24Z

Guile :

Video thumbnail Start on SB

Put a dice roll result in the sheet

2025-05-08T21:35:24Z

Guile : first tutorial

=== Summary ===
In this tutorial, we'll see how to fill a label based on a dice roll result.

You will see that the solution can only be made with some script, using a specific action button in the Dice Result.

=== Step by step ===

# create an element that will trigger the dice roll. Ex: a label with the id <code>labelTriggeringDiceRoll</code>
# create an element that will receive the dice roll result (or anything based on the dice roll). Ex: a label with the id <code>labelReceivingDiceRoll</code>
# in the script, add an click event that rolls the dice you need by using <code>Dice.roll</code>
# <code>Dice.roll</code> accepts a list of action buttons as last parameter. This is an object whose keys are the Button label that will be shown in the Dice log and values are a function that is called when the button is clicked (see the [https://lets-role.com/help/en/documentation/v1/scripting/dice-api Actions section in the Dice API documentation]). The parameter given to the function is a [https://lets-role.com/help/en/documentation/v1/scripting/dice-result Dice Result].
# If correctly defined, the function can have an elegant access to the sheet.
# This access to the sheet is the main way to change the desired label.

=== Final code ===
Here is the code used in the [https://lets-role.com/system/system-builder-demo-16760 System Builder Demo]
const labelToClick = sheet.get("labelTriggeringDiceRoll"); // get the label that will roll dice when clicked
labelToClick.on("click", function () { // handle the click event on the label
const actions = {}; // initiate the list of actions in dice result
actions[_("Apply to sheet")] = function (dice) { // add a translated button label
const labelToFill = sheet.get("labelReceivingDiceRoll"); // when click on the action button, the code can access to the label to change
labelToFill.value("Last roll was " + dice.total); // set anything in the label, based on dice
};
Dice.roll(sheet, "10+1D10", "Roll strength", "all", actions); // Roll the dice
});

=== Live example ===
You can see a live example in the [https://lets-role.com/system/system-builder-demo-16760 System Builder Demo] in the tab "Fill with Dice Result" (you must run a table in order to have dice rolls, the sheet preview block dice rolls)

You can check the code in the function <code>initFillWithRoll</code> that illustrates what is described in this tutorial.

System Builder

2025-05-08T20:28:06Z

Guile : First tutorial

=== Tutorials ===
[[Put a dice roll result in the sheet]]

Accueil

2025-01-27T09:47:11Z

Guile : fix a typo

= Bienvenue sur le Wiki de Let's Role =

== À propos de ce wiki ==

Ce wiki est dédié à [https://www.lets-role.com Let's Role], la plateforme de jeu de rôle en ligne. Il est créé et géré par la communauté. La société Let's Role, ses dirigeants et employés n'ont aucun lien direct avec la gestion de ce wiki. Les logos Let's Role sont utilisés avec la permission explicite et révocable de la SAS Let's Role.

== Nos motivations ==

* Centraliser les informations pour les [[Nouveaux arrivants]]
* Partager des conseils, astuces et bonnes pratiques sur le [[System Builder]]
* Documenter les fonctionnalités et les mises à jour de la plateforme
* Créer une ressource collaborative pour tous les utilisateurs (voir "Comment contribuer" juste en dessous)

== Comment contribuer ==

Pour préserver la qualité du contenu et nous protéger contre le spam, les comptes doivent être validés avant de pouvoir éditer des pages. Voici comment procéder pour contribuer :

# Rejoignez le [https://discord.gg/let-s-role-488658494891753473 Discord officiel de Let's Role]
# Contactez un archiviste du wiki sur le canal dédié
# Joindre votre pseudo sur le Wiki à la demande
# Attendez la validation de votre compte par un modérateur

Une fois votre compte validé, vous pourrez créer et modifier des pages du wiki.
*Par mesure de sécurité, les comptes de moins de 6 mois d'ancienneté ne seront pas admis.*

== Recommandations pour la contribution ==

* Vérifiez que l'information n'existe pas déjà avant de créer une nouvelle page
* Respectez les [[conventions d'édition]] du wiki
* Citez vos sources lorsque vous ajoutez des informations
* Soyez objectif et factuel dans vos contributions

== Traduction en anglais ==

Pour rendre le wiki accessible au plus grand nombre, nous encourageons la traduction des pages en anglais. Cependant :

* Évitez l'utilisation de traducteurs automatiques comme Google Translate
* Traduisez uniquement si vous avez une bonne maîtrise de l'anglais
* Assurez-vous que la traduction conserve le sens et la qualité de l'original

== Besoin d'aide ? ==

Si vous avez des questions ou besoin d'assistance, n'hésitez pas à contacter un archiviste sur le [https://discord.gg/let-s-role-488658494891753473 Discord de Let's Role] ou à consulter notre [[FAQ]].

Merci de votre intérêt pour le Wiki de Let's Role. Ensemble, construisons une ressource précieuse pour notre communauté !