Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
37 changes: 16 additions & 21 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -1,25 +1,20 @@
# eclipse
bin
*.launch
.settings
.metadata
.classpath
.project

# idea
out
build/
*.ipr
run/
*.iws
out/
*.iml
.idea

# gradle
build
.gradle
.gradle/
output/
bin/
libs/

# other
eclipse
run

# Files from Forge MDK
forge*changelog.txt
.classpath
.project
.idea/
classes/
.metadata
.vscode
.settings
*.launch
.architectury-transformer/
24 changes: 24 additions & 0 deletions LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.

In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to <http://unlicense.org/>
54 changes: 16 additions & 38 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
Item Transform Helper
==================
When you create a custom item, you need to provide ItemCameraTransforms for it. This project is an interactive
# Item Transform Helper

When you create a custom item, you need to provide ItemCameraTransforms for it. This project is an interactive
tool to help you get the transforms right by interactively adjusting them.

How to use:<br>
1) Place the ItemCamera somewhere in the player's hotbar<br>
1) Place the Camera item somewhere in the player's hotbar<br>
2) Hold the Item you want to modify in the player's hand<br>
3) Use the up/down keys to move up and down the menu.<br>
4) Use the left/right keys to edit the value (eg scaleX)<br>
5) To select a different view (eg first person, third person) use left/right to change the VIEW menu item.
4) Use the left/right keys to edit the value (e.g. scaleX)<br>
5) To select a different view (e.g. first person, third person) use left/right to change the VIEW menu item.
6) To modify the transform for an item on the ground:
* throw your Item onto the ground, and then put another copy of your Item into the player's hand
* Throw your Item onto the ground, and then put another copy of your Item into the player's hand
* Use left/right to change the VIEW menu item to grnd<br>
Use the same technique for items in the gui, on your head (eg pumpkin), fixed (in picture frames), or in the
player's left hand.
7) To reset the parameters for the current view, select the RESET menu item and press left or right. Use RESET ALL (RSTALL) to reset the parameters for all views. <br>
7) To reset the parameters for the current view, select the RESET menu item and press left or right. Use RESET ALL (RSTALL) to reset the parameters for all views.<br>
You can also copy parameters from a vanilla item to your custom item:
* Hold the vanilla item in your hand
* Select RESET or RSTALL, press left or right.
Expand All @@ -25,39 +25,17 @@ How to use:<br>
The item will appear in the Helpers tab in the creative inventory.

For background information on<br>
- items: see here http://greyminecraftcoder.blogspot.com/2013/12/items.html<br>
- rendering items: see here http://greyminecraftcoder.blogspot.com.au/2014/12/item-rendering-18.html<br>
- Items: see here https://greyminecraftcoder.blogspot.com/2013/12/items.html<br>
- Rendering items: see here https://greyminecraftcoder.blogspot.com/2014/12/item-rendering-18.html<br>
- This link describes the structure of the JSON Item Model file (see the Item Models section halfway down):<br>
- http://minecraft.gamepedia.com/Block_models
- https://minecraft.fandom.com/wiki/Model#Item_models

As an alternative to the Item Transform Helper, you can also use BlockBench (https://blockbench.net/) to determine the correct transforms for your model, i.e. either<br>
1) Create a new model in BlockBench; or<br>
2) Import an existing model (either the json model file, or the item "generated" texture)<br>

Thanks to Romejanic for updating to 1.12.2, and to lehrj for updating to 1.16.1!

## Licence Info:
This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.

In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to <http://unlicense.org/>
Thanks to ThexXTURBOXx for updating to 1.11.2 and Architectury (Forge + Fabric) 1.18.1, Romejanic for updating to 1.12.2, and to lehrj for updating to 1.16.1!

## Licence Info

See [here](https://github.com/TheGreyGhost/ItemTransformHelper/blob/master/LICENSE).
44 changes: 11 additions & 33 deletions ReadMeFirst.txt
Original file line number Diff line number Diff line change
@@ -1,20 +1,20 @@
Item Transform Helper
==================
When you create a custom item, you need to provide ItemCameraTransforms for it. This project is an interactive
When you create a custom item, you need to provide ItemCameraTransforms for it. This project is an interactive
tool to help you get the transforms right by interactively adjusting them.

How to use:
1) Place the ItemCamera somewhere in the player's hotbar
1) Place the Camera item somewhere in the player's hotbar
2) Hold the Item you want to modify in the player's hand
3) Use the up/down keys to move up and down the menu.
4) Use the left/right keys to edit the value (eg scaleX)
5) To select a different view (eg first person, third person) use left/right to change the VIEW menu item.
4) Use the left/right keys to edit the value (e.g. scaleX)
5) To select a different view (e.g. first person, third person) use left/right to change the VIEW menu item.
6) To modify the transform for an item on the ground:
a) throw your Item onto the ground, and then put another copy of your Item into the player's hand
a) Throw your Item onto the ground, and then put another copy of your Item into the player's hand
b) Use left/right to change the VIEW menu item to grnd
Use the same technique for items in the gui, on your head (eg pumpkin), fixed (in picture frames), or in the
player's left hand.
7) To reset the parameters for the current view, select the RESET menu item and press left or right. Use RESET ALL (RSTALL) to reset the parameters for all views.
7) To reset the parameters for the current view, select the RESET menu item and press left or right. Use RESET ALL (RSTALL) to reset the parameters for all views.
You can also copy parameters from a vanilla item to your custom item:
a) Hold the vanilla item in your hand
b) Select RESET or RSTALL, press left or right.
Expand All @@ -25,40 +25,18 @@ How to use:
The item will appear in the Helpers tab in the creative inventory.

For background information on
- items: see here http://greyminecraftcoder.blogspot.com/2013/12/items.html
- rendering items: see here http://greyminecraftcoder.blogspot.com.au/2014/12/item-rendering-18.html
- Items: see here https://greyminecraftcoder.blogspot.com/2013/12/items.html
- Rendering items: see here https://greyminecraftcoder.blogspot.com/2014/12/item-rendering-18.html
- This link describes the structure of the JSON Item Model file (see the Item Models section halfway down):
http://minecraft.gamepedia.com/Block_models
https://minecraft.fandom.com/wiki/Model#Item_models

As an alternative to the Item Transform Helper, you can also use BlockBench (https://blockbench.net/) to determine the correct transforms for your model, i.e. either
1) Create a new model in BlockBench; or
2) Import an existing model (either the json model file, or the item "generated" texture)

Thanks to Romejanic for updating to 1.12.2, and to lehrj for updating to 1.16.1!
Thanks to ThexXTURBOXx for updating to 1.11.2 and Architectury (Forge + Fabric) 1.18.1, Romejanic for updating to 1.12.2, and to lehrj for updating to 1.16.1!

--------------
Licence Info
This is free and unencumbered software released into the public domain.

Anyone is free to copy, modify, publish, use, compile, sell, or
distribute this software, either in source code form or as a compiled
binary, for any purpose, commercial or non-commercial, and by any
means.

In jurisdictions that recognize copyright laws, the author or authors
of this software dedicate any and all copyright interest in the
software to the public domain. We make this dedication for the benefit
of the public at large and to the detriment of our heirs and
successors. We intend this dedication to be an overt act of
relinquishment in perpetuity of all present and future rights to this
software under copyright law.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.

For more information, please refer to <http://unlicense.org/>
See here: https://github.com/TheGreyGhost/ItemTransformHelper/blob/master/LICENSE
Loading