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 & [put it into the datapack folder in your map](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.** [Make your own datapack](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: ![The screenshot that demonstrates the X-Y coordinates from the example code](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: - [For 1.21.5](https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201.21.5/data/ftmc/function/touchsign/demo/give_debug_sign.mcfunction) | [For 1.20.5 - 1.21.4](https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201.21/data/ftmc/function/touchsign/demo/give_debug_sign.mcfunction) | [For 1.20 - 1.20.4](https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201.20/data/ftmc/functions/touchsign/demo/give_debug_sign.mcfunction) | [For 1.14 - 1.19.4](https://github.com/flashteens/FTMCTouchSign/blob/main/FTMC%20TouchSign%20Framework%20for%201.14/data/ftmc/functions/touchsign/demo/give_debug_sign.mcfunction) | [For 1.13 - 1.13.2](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 [Force Unicode Font option](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! 😄 ## FAQs 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 [GitHub issues page](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 ±2,147,000 blocks from the spawn point. This issue might happen if you go outside from this range. ## Source Code See on [my GitHub repository](https://github.com/flashteens/FTMCTouchSign). ## Usage Terms This project is licensed under a [Creative Commons BY-SA 4.0 License](https://creativecommons.org/licenses/by-sa/4.0/deed.en). Feel free to use and share this datapack for any public or private usages as long as: * You ensure to **credit the author** of this datapack: `flashteens` or `FTMC` when using this datapack in your public projects (ex: your Minecraft map or any derivative datapacks that use the FTMC TouchSign Datapack as a dependency.) * For those who manages to **modify** the FTMC TouchSign Datapack **itself**, it is suggested that you use it **for private usages only**. Do NOT re-distribute it to public **except for** the following scenarios: 1. The case when you are publishing another **non-datapack** project (ex: a world save) that **contains** your modified version from the FTMC TouchSign Datapack. * For this case, please still clarify the original author in the credit sections of your post. 2. The case when you are publishing another **datapack** project _(referred to as **A**)_ that **contains** your modified version from the FTMC TouchSign Datapack _(referred to as **B**)_. * For this case, your may provide the download links of both _**A**_ and _**B**_ in your post, but please focus on your datapack _**A**_ in the description. * Datapack _**A**_ itself **should NOT** be a modified version from on the FTMC TouchSign Datapack. * Also please clarify the original author of datapack _**B**_ in your post. 3. Forking/cloning the source code of FTMC TouchSign Datapack to your GitHub or other source code repositories for **backup purposes**. * If it is a public repository, please also clarify the original author in your descriptions. * **DISCLAIMER:** NOT to be confused with [another Bukkit plugin named "Touchsigns", which also has similar features but is for Bukkit-based servers only](https://github.com/WesternIcelander/Touchsigns). **This datapack has no relation or source code references with that plugin.** :)