FTMC TouchSign Datapack

This is a datapack framework that lets you use a sign like a touchscreen. In other words, it gives your datapack the ability to tell which part of a wall sign that a player clicked on.

How to use this framework:

Step1. Download this datapack framework & (https://minecraft.wiki/w/Tutorials/Installing_a_data_pack). Please check your Minecraft version and download the corresponding datapack from one of the links on this page.

Step2. (https://minecraft.wiki/w/Tutorials/Creating_a_data_pack) and put it into the same datapack folder.

In your datapack, there must be an `mcfunction` file that invocates the FTMC TouchSign framework, so you will get some information about the clicking position.

For an example, we create a file called onclick.mcfunction and put it in your datapack: ``` function ftmc:touchsign/click_handler execute if score @s fttsign_touchx matches .. if score @s fttsign_touchy matches .. run execute if score @s fttsign_touchx matches .. if score @s fttsign_touchy matches .. run # Please replace X1 ~ X4 and Y1 ~ Y4 above with the exact coordinate values. ```

In this function, `fttsign_touchx` and `fttsign_touchy` refers to the coordinates that the player clicks onto the sign.

`fttsign_touchx` ranges from `-500` (leftmost) to `500` (rightmost) `fttsign_touchy` ranges from `-250` (top) to `250` (bottom)

The example above will make your sign run `` when clicking on the pink zone of the following screenshot & and run `` when clicking on the green zone below: !(https://cdn.modrinth.com/data/cached_images/ffacbf0f3de2650b11b08988dca5bedc4e0a388d.png)

Step3. Make a clickable sign and obtain the sign with a `/give` command. Some examples can be seen on the demo folders of this project.

Click on the links below for the example in each corresponding Minecraft version: - (https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201. 21. 5/data/ftmc/function/touchsign/demo/give_debug_sign.mcfunction) | (https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201. 21/data/ftmc/function/touchsign/demo/give_debug_sign.mcfunction) | (https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201. 20/data/ftmc/functions/touchsign/demo/give_debug_sign.mcfunction) | (https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201. 14/data/ftmc/functions/touchsign/demo/give_debug_sign.mcfunction) | (https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201. 13/data/ftmc/functions/touchsign/demo/give_debug_sign.mcfunction)

## When to use this framework in my project

This framework provides several demo examples as follows: A debug sign - This is where you may check how the clicking positions on the sign may affect scoreboard values. A computer keyboard (with two variants available for whether or not the (https://minecraft.wiki/w/Options#Font_Settings) is enabled) - This simulates how a real computer keyboard behaves. By clicking onto the position of a letter, a debug message containing the letter will show on the chat. A piano keyboard - Playing range: C3 - C5 (25 keys) - By clicking onto different keys on the piano sign, it plays the sound in different frequencies, resembling how it acts on an actual piano.

All these examples can be found in the source code & you may obtain the sign items by running any of the commands like `/function ftmc:touchsign/demo/give_xxxxx_sign` (where `xxxxx` should be replaced.)

These usages are just a few examples. You might still discover quite some other interesting and practical usages. Feel free to publish your own datapack that uses this framework as long as you follow the "Usage Terms" section written below. Hope you enjoy! 😄

1. I'm creating a new map and trying to import the FTMC TouchSign datapack, but it tells me "Incompatible!" Please first ensure that the datapack you downloaded corresponds to the correct Minecraft version. If correct, please ignore the "Incompatible" warning and import it into your world anyway. It should be still working. If you found any issues in the gameplay, please report it as a bug in the (https://github.com/flashteens/FTMCTouchSign/issues).

2. The datapack doesn't correctly detect the clicking position when I'm going far away from the spawn point. * Due to the limitations of scoreboard data types (32-bit signed integers) combining with some multiplication operations, we only expect it work properly when X and Z coordinates range within about ±