GITBOOK-2: No subject

Author: NSPC911

gitbook/README.md

@@ -19,6 +19,9 @@ layout:
 
 Thank you for checking out the documentation! This should contain everything from why BEComTweaks exists, to the fine details on how it works, and how to contribute!
 
-#### Jump right in
+If you need more help, you are welcome to join our discord! It is available at [https://becomtweaks.github.io/discord](https://becomtweaks.github.io/discord)
+
+#### Jump right in!
+
+<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Getting Started</strong></td><td>Learn on the basics required in any repo!</td><td><a href="getting-started.md">getting-started.md</a></td></tr><tr><td><strong>Creating new things</strong></td><td>Learn to create new items like Packs, Sections and Compatibilities</td><td><a href="broken-reference">Broken link</a></td></tr><tr><td><strong>Who are we?</strong></td><td>Want to know who we are?</td><td><a href="who-are-we.md">who-are-we.md</a></td></tr></tbody></table>
 
-<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Getting Started</strong></td><td>Learn on the basics required in any repo!</td><td><a href="getting-started.md">getting-started.md</a></td></tr><tr><td><strong>Creating new things</strong></td><td>Learn to create new items like Packs, Sections and Compatibilities</td><td><a href="broken-reference">Broken link</a></td></tr><tr><td><strong>Who are we?</strong></td><td>Want to know who we are?</td><td></td></tr></tbody></table>

gitbook/SUMMARY.md

@@ -11,3 +11,12 @@
 
 * [New Category](new-category.md)
 * [New Compatibility](new-compatibility.md)
+
+## Miscellaneous
+
+* [FAQ](miscellaneous/faq.md)
+
+***
+
+* [Impossible Packs](impossible-packs.md)
+* [Who are we?](who-are-we.md)

gitbook/creating-a/new-pack.md

@@ -14,6 +14,7 @@ Open the newly cloned folder using VSCode. In the directory list, open the `json
 
 The format for a pack is as follows
 
+{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}
 ```json
 {
   "pack_id": "<pack id>",
@@ -31,6 +32,7 @@ The format for a pack is as follows
   "regolith": "<bool>"
 }
 ```
+{% endcode %}
 
 The only required definitions are `pack_id`, `pack_name` and `pack_description`. For the rest, they aren't required. Let's go through what each one defines.
 
@@ -59,12 +61,14 @@ The only required definitions are `pack_id`, `pack_name` and `pack_description`.
 * An extra stylised description is used to provide additional information to the user. This has no purpose in the backend.
 * Must be in the format below, but can be omitted
 
+{% code overflow="wrap" fullWidth="true" %}
 ```json
 "message": [
   "error/info/warn",
   "<information>"
 ]
 ```
+{% endcode %}
 
 * A message of level `error` has the information show up as <mark style="color:red;">red</mark>
 * A message level of `info` has the information show up as <mark style="color:blue;">cyan</mark>
@@ -102,29 +106,37 @@ After you have created the pack icon,&#x20;
 
 Now, using your terminal, head to the folder with the repository. Ensure that you have an active Python Virtual Environment (refer to [#setting-up-the-modules](../getting-started.md#setting-up-the-modules "mention") if you have not set it up). Run
 
+{% code overflow="wrap" fullWidth="true" %}
 ```sh
 python pys/pre_commit.py --format
 ```
+{% endcode %}
 
 You can choose to add in a `--no-stash` if you are sure you won't accidentally nuke your workspace.
 
 After the script finishes running, you can run
 
+{% code overflow="wrap" fullWidth="true" %}
 ```sh
 git status
 ```
+{% endcode %}
 
 to see your changed files. If they are all right, you can run
 
+{% code overflow="wrap" fullWidth="true" %}
 ```sh
 git add .
 ```
+{% endcode %}
 
 to stage your added files, then
 
+{% code overflow="wrap" fullWidth="true" %}
 ```sh
 git commit -m "<message>"
 ```
+{% endcode %}
 
 where `<message>` is a summary of the changes you made. Finally, run
 

gitbook/getting-started.md

@@ -60,24 +60,30 @@ You should now see a new directory with the name you set.
 
 Create a new python environment using either python's `venv` module by running
 
+{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}
 ```sh
 python -m venv venv
 venv/Scripts/activate
 python -m pip install -r requirements.txt
 ```
+{% endcode %}
 
 or using [uv](https://docs.astral.sh/uv/getting-started/installation/#highlights)
 
+{% code overflow="wrap" lineNumbers="true" %}
 ```sh
 uv venv venv
 venv/Scripts/active
 uv pip sync requirements.txt
 ```
+{% endcode %}
 
 If you are working on server-backend or want the formatter, make sure to run
 
+{% code overflow="wrap" fullWidth="true" %}
 ```sh
 pnpm install
 ```
+{% endcode %}
 
 That's it! You have setup the repository for editing!

gitbook/impossible-packs.md

@@ -0,0 +1,176 @@
+---
+icon: circle-xmark
+---
+
+# Impossible Packs
+
+## Impossible Packs <a href="#impossible-packs" id="impossible-packs"></a>
+
+A non-exhaustive page on packs that will **NOT** be added to both BedrockTweaks due to Bedrock issues and DrAV's preferences.\
+Keep in mind that some might be added to BEComTweaks as toned-down versions.
+
+### Resource Packs <a href="#resource-packs" id="resource-packs"></a>
+
+**1. Bushy Leaves**
+
+There is no way to edit a block's geometry to make it bushy in Vanilla Bedrock. While pre-defined blockshapes can be used, with the closest one being Cactus, it does not match the original aesthetic of Bushy Leaves, hence why it is left out.
+
+**2. Visual Cauldron Stages**
+
+Cauldron does not support transparent textures, so just removing the center line doesn't help. Cauldrons do not have any visual changes when adding/removing water/powdered snow.\
+However, Lava Cauldrons do have a seperate Block State, but that misses the entire point of Visual Cauldron Stages.
+
+**3. Visual Honey Stages**
+
+The Bee Hive and Nest only visually change while full, so any other progress in-between cannot be shown in the pack. This prevents DrAV from adding the pack to BedrockTweaks
+
+Available on BEComTweaks. [Link ↗](https://becomtweaks.github.io/resource-packs/?st_raw=N4IgTghg7iBcDaIBiBXANmgEgewHYFMBPAZQBcIBzfEAXQF8g)
+
+**4. Visual Noteblock Pitch**
+
+Noteblocks have no change in Block States when switching pitches or instruments, so having it change textures is out of the question. However, [lonelyang](https://github.com/lonelyang) discovered that you can edit the Particle emitted by the Note Block to show the current Pitch of it. Again, DrAV doesn't like the implementation of it and will not add it to Bedrock Tweaks
+
+Available on BEComTweaks. [Link ↗](https://becomtweaks.github.io/resource-packs/?st_raw=N4IgTghg7iBcDaIByB7ALgUwEIBsUGMBrABQEs18ALYiMNU-HDEAXQF8g)
+
+**5. Directional Droppers and Dispensers**
+
+This is because of Minecraft Bedrock's issue. Mojang decided to combine both the sideways facing dropper textures and the vertical facing dropper textures into a single block without any blockstates.
+
+<details>
+
+<summary>Technical Findings</summary>
+
+`blocks.json`
+
+{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}
+```json
+"dropper" : {
+  "sound" : "stone",
+  "textures" : {
+    "down" : "dropper_top",
+    "east" : "dropper_front_vertical",
+    "north" : "dropper_side",
+    "south" : "dropper_front_horizontal",
+    "up" : "dropper_top",
+    "west" : "dropper_side"
+  }
+}
+```
+{% endcode %}
+
+Have you noticed the East and South textures?
+
+{% code fullWidth="true" %}
+```json
+    "down" : "dropper_top",
+    "east" : "dropper_front_vertical", 
+    "north" : "dropper_side",
+    "south" : "dropper_front_horizontal", 
+    "up" : "dropper_top",
+```
+{% endcode %}
+
+Yeah, Mojang decided to set the Upwards and Downwards facing Dropper textures with East and South. They couldn't bother setting a special blockshape for them, like the hopper. What a party pooper.
+
+</details>
+
+Available on BEComTweaks. [Link ↗](https://becomtweaks.github.io/resource-packs/?st_raw=N4IgTghg7iBcDaIAiBLMBTAxgFxQewDsIAbVAZwAd0Cz0wyQAaZNLXQkpMPCq%2BkALoBfIA)
+
+**6. Most of the 3D Category**
+
+Currently supported 3D Packs are 3D Mace and 3D Sun and Moon. [BEComTweaks](https://becomtweaks.github.io/resource-packs) also has 3D Fungi, but anything else is not possible mainly because Custom Geometry cannot be set for Vanilla Blocks. 3D Fungi itself was made using Azalea's Block Shape.
+
+**7. Connected Textures**
+
+Only borderless versions, like Borderless Glass is available, as a block is unable to check whether there is another block of the same type touching it. Shaders could be made, but they aren't officially supported on the main version.
+
+**8. Wavy Leaves and Plants**
+
+Either with a flipbook texture or shaders.
+
+* Shaders\
+  Not possible as it is not officially supported.[<sup>\[1\]</sup>](https://becomtweaks.github.io/docs/misc/impossible-packs.html#fn1)
+* Flipbook Texture\
+  Very demanding, especially on mobile as it utilises extremely high resolution textures
+
+**9. Fullbright/Hardcode Darkness/Warm Glow/Mob Spawn Indicator**
+
+No shader support.
+
+**10. Endless End Rods**
+
+Requires a bit more testing. Theoretically, adding a `"blockshape": "block"` should fix it, but the block turns black.
+
+**11. Randomly Rotated Sunflowers / Taller Sunflowers**
+
+Custom Geometry can't be set for Vanilla Blocks.
+
+**12. Redstone Power Levels**
+
+No shader support. There is a buggy version by dhan on mcpedl which doesn't show directions. [Link ↗](https://mcpedl.com/redstone-signal-indicator-for-mcpe/)
+
+**13. Groovy Levers**
+
+Custom Geometry can't be set for Vanilla Blocks.
+
+**14. Visual Sapling Growth**
+
+No block states to depend on to change textures.
+
+**15. No Beacon Beam**
+
+Beacon Beam doesn't support opacity, so if I put a transparent texture, the beam would just turn black.
+
+**16. Old Alex & Steve / Dungeons Alex & Steve**
+
+Minecraft no longer loads Alex and Steve textures from resource packs.
+
+**17. Big Dripleaf Stem Fix / Small Dripleaf Stem Fix**
+
+Can't make sure the stem properly use the texture, so it could result in the wrong side having no stems
+
+**18. Slime Particle Fix / Proper Break Particles / Don't Eat the Bowl**
+
+Vanilla bug that cannot be fixed. The particles' colors cannot be changed and are hardcoded by default.
+
+**19. Iron Bars Fix**
+
+General Issue. Z-Fighting cannot usually be fixed unless the shader is properly set or the cube is above the other cube by the smallest dimensions. However, shaders can't be changed and custom geometry cannot be set.
+
+**20. Pixel Consistent Trip Wire**
+
+Custom Geometry can't be set for Vanilla Blocks.
+
+**21. Diminshing Tools**
+
+The current durability can be obtained, but the item texture cannot be changed based on the durability. Even if it was able to, there would be a ton of textures, lagging the game a lot.
+
+**22. Spinning Skull on Fire Painting**
+
+Minecraft Bedrock has all the painting in a single PNG file of resolution 256x256. There are, at minimum, 12 frames. The resolution would become 256x3072. Yeah.
+
+### Crafting Tweaks <a href="#crafting-tweaks" id="crafting-tweaks"></a>
+
+None at the moment.
+
+### Behaviour Packs <a href="#behaviour-packs" id="behaviour-packs"></a>
+
+**1. Player Heads**
+
+**Player Drop Heads** is entirely possible as the game stands right now, but not how you would expect it to function. World Owners would have to do a bit or a lot of manual file editting to make the packs work, and you would be responsible for keeping it up to date as best as you can - we provide the script you provide the textures sort of arrangement.
+
+<details>
+
+<summary>Technical Jargon and Reasoning</summary>
+
+The main reason a pack like this would work in game is its quite easy to make a custom block with the skull geometry and provide a flattened player skin (or part of it) so that the block will have all the correct textures on each side to represent the head, the issue stems from we have no way of doing just that without manually doing it. Whilst yes there is a HTTP library as part of the @minecraft Scripting API (not to be confused with Legacy Scripting), we cannot save the result of the call to the file system the server is running on, even with Bedrock Dedicated Server Software (the only place that currently is even allowed to use the HTTP library). So we cannot generate the "player head" blocks in runtime, which is ideally how and when it should be done so our pack remains small in size and compatible with everyone's systems.
+
+</details>
+
+There is hope and a possible solution, but its ugly. If someone was willing to put the effort into making a "Player Head Generator" we could ask players to upload their skins, then the system would generate a pack including all the skins they wanted (like Hermit Heads + our ugly mugs on the dev team) and their own, they could then use the generated pack. However this would require significant resources that DrAv cannot spare.
+
+> \~ SquatchHunter, Moderator of drav.dev and member of Bedrock Tweaks
+
+**2. Off-Hand**
+
+It became impossible after 1.20 when Mojang updated the Beta API system to prevent any changes to the player on the gametick that an event happens. FoxyNoTail's [Offhand Addon](https://foxynotail.com/add-ons/off-hand/) heavily relied on this, as it needed the event to change objects from mainhand to offhand on the same gametick that you are placing the block.

gitbook/miscellaneous/faq.md

@@ -0,0 +1,19 @@
+---
+icon: question
+---
+
+# FAQ
+
+## FAQ <a href="#faq" id="faq"></a>
+
+**1. When will Addons come back?**
+
+Soon™
+
+Addons will take a while to be added to [Bedrock Tweaks](https://bedrocktweaks.net) as DrAV is making some addon bases and making sure they work in the latest version, 1.21. Currently, [BEComTweaks](https://becomtweaks.github.io/behaviour-packs) still have some important addons.
+
+**2. When will X be added? / Why is Y not added yet?**
+
+Refer to Impossible Packs before asking this.
+
+The list will continue to expand as more questions are asked.

gitbook/new-category.md

@@ -10,6 +10,7 @@ Open the folder with VSCode. Inside the folder sidebar, open `jsons/packs`. Crea
 
 ### JSON Format
 
+{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}
 ```json
 {
   "$schema": "https://becomtweaks.github.io/schema/packs.json",
@@ -19,6 +20,7 @@ Open the folder with VSCode. Inside the folder sidebar, open `jsons/packs`. Crea
   "packs": []
 }
 ```
+{% endcode %}
 
 The required keys are `topic` and `packs` while `$schema` helps for autocomplete (important!)
 
@@ -53,9 +55,11 @@ Open the `app.js` inside `webUI` and add the following at the end of the `catego
 
 Now run
 
+{% code overflow="wrap" fullWidth="true" %}
 ```sh
 python pys/pre_commit.py --format --no-stash
 ```
+{% endcode %}
 
 And it should be reflected inside `webUI/index.html`. Open it up with any browser and you should see the new category!
 

gitbook/new-compatibility.md

@@ -6,7 +6,7 @@ icon: nfc
 
 BEComTweaks had just received its overhauled compatibility handler, so here is a full doc on it
 
-<pre class="language-json"><code class="lang-json">{
+<pre class="language-json" data-overflow="wrap" data-line-numbers data-full-width="true"><code class="lang-json">{
   "max_simultaneous": 3,
   "3way": [
     {
@@ -60,6 +60,7 @@ Say you want to add a 4 way compatibility while using the example `compatibility
 
     Here is how the key would look like
 
+{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}
 ```json
  "4way": [
     {
@@ -74,6 +75,7 @@ Say you want to add a 4 way compatibility while using the example `compatibility
     }
   ],
 ```
+{% endcode %}
 
 What do each of the keys do?
 

gitbook/who-are-we.md

@@ -0,0 +1,24 @@
+---
+icon: face-thinking
+---
+
+# Who are we?
+
+We are **B**edrock **E**dition **Com**munity **Tweaks**, also known as BEComTweaks.
+
+* Take BedrockTweaks as the popular guy in school.
+* BEComTweaks is that nerdy guy who wants the same attention.
+
+Started out as a mini-project back in March, it is now a full-time project aimed to challenge Bedrock Tweaks.
+
+***
+
+#### What is the difference between BedrockTweaks and BEComTweaks? <a href="#what-is-the-difference-between-bedrocktweaks-and-becomtweaks" id="what-is-the-difference-between-bedrocktweaks-and-becomtweaks"></a>
+
+1. More packs!
+   * BEComTweaks has 500+ resource packs alone that is available right on our site. These did not have to be in VanillaTweaks and are available for more to know about.
+2. More updates!
+   * BEComTweaks is updated daily!
+     * This can be in branches or on the main one, but I assure you, we never lose our streak!
+3. Behaviour Packs!
+   * BEComTweaks will always leave behaviour packs on! Addons are coming soon™ as well!