Skip to content

Commit

Permalink
Update documents
Browse files Browse the repository at this point in the history
  • Loading branch information
@mchorse
mchorse committed Dec 28, 2018
1 parent 5f00786 commit 4f0a368
Show file tree
Hide file tree
Showing 2 changed files with 53 additions and 9 deletions.
39 changes: 39 additions & 0 deletions CHANGELOG.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,45 @@

Blockbuster's change log.

## Version 1.5.3

This patch update is quite massive in comparison to two previous patches. This update adds body part system, image morphs, a new Aperture integration, URL textures, few miscellaneous tweaks and lots of bug/crash fixes.

**Compatible** with McLib `1.0`, Metamorph `1.1.7` and Aperture `1.2`. It doesn't mean that future versions of Metamorph and Aperture would be incompatible, but older versions are most likely incompatible.

<a href="https://youtu.be/sWlh0LUvvMc"><img src="https://img.youtube.com/vi/sWlh0LUvvMc/0.jpg"></a>

* Added `mclib` library mod as a dependency
* Added body part system to Blockbuster custom model system, which allows adding sub models on a model
* Added custom model and image morph editors
* Added **Image morph** which simply shows an image
* Added `Wheel` and `Wing` animation checkboxes to model editor
* Added **chat action prefix** config option
* Added `/model export_obj <model> [pose]` subcommand which allows to export Blockbuster custom models into OBJ
* Added `/model convert <fred|steve> <skin>` which allows converting `64x64` skins into `64x32` and vice versa
* Added `/spectate <target>` command
* Added `map_Kd_path` instruction to MTL parser which allows to specify default texture for the material (suggested by AzureZhen)
* Added `mounted` property to `/record clean`
* Added support of elytra layer to the slot mechanism
* Added a button to rename replay Recording ID prefixes in director block
* Added a button to copy pose properties from another pose and a button to duplicate a limb in model editor
* Added blending to default cubic limbs in custom model, which allows using semi-transparent skins
* Added URL support to resource locations
* Added a keybind which allows toggle playback of currently edited director block in dashboard GUI (suggested by Olrik&Flynn)
* Added support for recording editor within camera editor
* Fixed crash and disabled ability to parent limb to itself in the model editor (reported by El_Redstoniano)
* Fixed crash caused by malformed model morph with no model (reported by KazerLight)
* Fixed crash caused by model manager releasing memory on the integrated server (GL context on wrong thread)
* Fixed crash with empty slot (reported by Qsycho)
* Fixed crash with item playback and body actors (reported by Olrik&Flynn)
* Fixed issue with bow animation not recognizing children limbs (reported by MineLol and ZeNoob)
* Fixed morphs not appearing correctly when scrubbing through in camera editor (reported by GroupM)
* Fixed an issue with 3D extruded limbs and normals (reported by ItzCactus)
* Removed custom model morph builder
* Removed the mob model export button from the main menu model editor (reported by NlL5)
* Updated **Chinese** translation strings (thanks to ycwei982)
* Updated **Russian** translation strings (thanks to Andruxioid)

## Version 1.5.2

This patch update adds more colored blocks for chroma keying and fixes lots of things (including pose editor that I broke in `1.5.1`).
Expand Down
23 changes: 14 additions & 9 deletions README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -23,36 +23,37 @@ Blockbuster mod provides you with lots of features to make cool machinimas/rolep
* **Actors and player recording** – the most important feature, as you won't be able to create a machinimas without it. With Blockbuster mod you can record yourself doing things and then playback it using an actor. *Recording code has some limitations on which actions it can record*. See [Blockbuster Wiki](https://github.com/mchorse/blockbuster/wiki) for more information about limitations.
* **Director blocks** – one actor is good, a crowd of them is even better. Blockbuster mod provides you with a mechanism called *director block* which manages playback of registered actors. It allows you to record actors. It also has outlets for redstone contraptions, making it easy attaching some custom commands or redstone logic on start or the end of the scene playback.
* **Model block** – besides actors, Blockbuster also adds a *model block*, allowing you placing down custom models or mobs as static props, which allows creating magnificient and immersive scenes. Besides placing them down, you can also hold those models or mobs in your hand (this feature available only in 1.12.2 build of the mod).
* **[Aperture](https://minecraft.curseforge.com/projects/aperture) support** – camera is how you present your machinima. Blockbuster mod has built-in Aperture integration. When Aperture is loaded, Blockbuster mod provides you with some features such as: ability to attach camera profiles to playback button, and previewing director block playback while editing cameras in the camera editor.
* **[Aperture](https://minecraft.curseforge.com/projects/aperture) support** – camera is how you present your machinima. Blockbuster mod has built-in Aperture integration. When Aperture is loaded, Blockbuster mod provides you with some features such as: ability to attach camera profiles to playback button, previewing director block playback while editing cameras in the camera editor and editing the player recording actions within camera editor.
* **Custom models** – recording only player-like entities limits the originality of your machinimas. Blockbuster mod let's you create custom models using in-game model editor. Unleash your creativity with custom models!
* **OBJ models** – beside custom models which can be created with in-game custom model editor, Blockbuster also supports OBJ models on top of custom JSON models!
* **Mobs support** – thanks to [Metamorph](https://minecraft.curseforge.com/projects/metamorph)'s public API, Blockbuster is capable of using any morphs which Metamorph provides to be used by Blockbuster actors.
* **[Minema](http://www.minecraftforum.net/forums/mapping-and-modding/minecraft-mods/2790594-minema-unofficial-the-smooth-movie-recorder) compatability** – thanks to frame-based player recording and cameras, you can convert your in-game machinimas to videos with a press of a button.
* **Green screen features** – Blockbuster adds glowing green blocks without any shading and an option to turn the sky fully green which makes it easier creating green screens for post processing of your machinimas.
* **Speaks multiple languages** – besides English, Blockbuster is also translated into Russian and Chinese thanks to [Andruxioid](https://www.youtube.com/channel/UCnHOceBjwMyqCR5oYOoNqhQ) and [ycwei982](https://www.youtube.com/channel/UCfUDMSGlXUblXimkvNl_7Ww), respectively.

## Install

Install [Minecraft Forge](http://files.minecraftforge.net/), download the latest stable version of jar file for available minecraft version. Also install following mods: [Metamorph](https://minecraft.curseforge.com/projects/metamorph). Put it in minecraft's `mods` folder, and launch the game.
Install [Minecraft Forge](http://files.minecraftforge.net/), download the latest stable version of jar file for available minecraft version. Also install following mods: [McLib](https://minecraft.curseforge.com/projects/mchorses-mclib), and [Metamorph](https://minecraft.curseforge.com/projects/metamorph). Put it in minecraft's `mods` folder, and launch the game.

After that, Blockbuster mod should be installed and will appear in Minecraft's mods menu. If Blockbuster didn't appear in the mods menu, then something went wrong.

## Videos

### Tutorial videos

Feature videos for 1.4. This playlist shows how to use the mod features. Almost every update comes with a change log video which show out new features.
This playlist shows how to use the mod features. Almost every update comes with a change log video which show out new features.

<a href="https://youtu.be/g5zrqiI_Udk?list=PL6UPd2Tj65nEwg2bfY-NduLihPy6fgnvK"><img src="https://img.youtube.com/vi/g5zrqiI_Udk/0.jpg"></a>
<a href="https://youtu.be/sWlh0LUvvMc?list=PL6UPd2Tj65nEwg2bfY-NduLihPy6fgnvK"><img src="https://img.youtube.com/vi/sWlh0LUvvMc/0.jpg"></a>

There's also a video that shows how to create a simple machinima using Blockbuster mod. This video shows basics of director block, how to attach actors to director block, and how to setup cameras:

<a href="https://youtu.be/cVTIzKzWtqg?list=PL6UPd2Tj65nE0Pmf6GD2Fk3aRGWTGKlZk"><img src="https://img.youtube.com/vi/cVTIzKzWtqg/0.jpg"></a>
<a href="https://youtu.be/PFS2yjXnIGI?list=PL6UPd2Tj65nE0Pmf6GD2Fk3aRGWTGKlZk"><img src="https://img.youtube.com/vi/PFS2yjXnIGI/0.jpg"></a>

### Machinima Examples

This playlist consists out of videos that I've created a bunch of machinimas during Blockbuster mod testings and just when I felt like. Earlier of those videos are my lab experiments.
This playlist consists out of videos that I've created a bunch of machinimas during Blockbuster mod testings and just when I felt like. Feel free to check out my crazy videos.

<a href="https://youtu.be/3uMywkj1_Gs?list=PL6UPd2Tj65nFdhjzY-z6yCJuPaEanB2BF"><img src="https://img.youtube.com/vi/3uMywkj1_Gs/0.jpg"></a>
<a href="https://youtu.be/1WHB5PeMhUE?list=PL6UPd2Tj65nFdhjzY-z6yCJuPaEanB2BF"><img src="https://img.youtube.com/vi/1WHB5PeMhUE/0.jpg"></a>

## For mod reviewers and reposters

Expand All @@ -67,7 +68,11 @@ When reposting my mod on your own website or reviewing it, please consider follo

If you're interested in this project, you might as well follow me on any of social media accounts listed below:

[![YouTube](http://i.imgur.com/yA4qam9.png)](https://www.youtube.com/channel/UCWVDjAcecHHa8UrEWMRGI8w) [![Discord](http://i.imgur.com/gI6JEpJ.png)](https://discord.gg/qfxrqUF) [![Twitter](http://i.imgur.com/6b8vHcX.png)](https://twitter.com/McHorsy) [![GitHub](http://i.imgur.com/DmTn1f1.png)](https://github.com/mchorse)
[![YouTube](http://i.imgur.com/yA4qam9.png)](https://www.youtube.com/channel/UCWVDjAcecHHa8UrEWMRGI8w) [![Discord](http://i.imgur.com/gI6JEpJ.png)](https://discord.gg/qfxrqUF) [![Twitter](http://i.imgur.com/6b8vHcX.png)](https://twitter.com/McHorsy) [![GitHub](http://i.imgur.com/DmTn1f1.png)](https://github.com/mchorse)

Also, I would really appreciate if you will support me on Patreon!

[![Become my Patron](https://i.imgur.com/4pQZ2xW.png)](https://www.patreon.com/McHorse)

## Bug reports

Expand All @@ -83,4 +88,4 @@ Language files are compiled from YML (which are located in `help/` folder) to IN

If you're going to work with localization strings, modify the appropriate YML file, first. Then use the `./gradlew buildLangFiles` command to convert YML to INI format `.lang` files directly to `src/main/resources/assets/blockbuster/lang` folder. Don't forget to refresh your IDE after building the langauge files.

Also, you need [Aperture](https://github.com/mchorse/aperture)'s and [Metamorph](https://github.com/mchorse/blockbuster)'s dev builds. Build them and then grab `-sources.jar` and `-dev.jar` to `run/libs/` folder, and refresh the IDE.
Also, you need [Aperture](https://github.com/mchorse/aperture)'s, [McLib](https://github.com/mchorse/mclib) and [Metamorph](https://github.com/mchorse/blockbuster)'s dev builds. Build them and then grab `-sources.jar` and `-dev.jar` to `run/libs/` folder, and refresh the IDE.

0 comments on commit 4f0a368

Please sign in to comment.