Difference between revisions of "Extensions:Character Creator"

From Lorekeeper Wiki
Jump to navigation Jump to search
(Created page with "{{subst:Extension Page}}")
Tag: 2017 source edit
 
Tag: 2017 source edit
 
Line 1: Line 1:
{{Extensioninfobox|title=the extension's name|desc=A short description|auth=Author(s)|status=status (such as WIP, testing, stable)|github={{Github|user=username|branch=branch}}|LKVer=What Lorekeeper version the ext is built on|migration=yes/no|package=yes/no}}
+
{{Extensioninfobox|title=Character Creator|desc=Create characters similar to dollmakers from your own art!|auth=Cylunny|status=testing|github={{Github|user=Cylunny|branch=extension/character-creator}}|LKVer=2.1.7|migration=yes|package=no}}
<!-- Put a short summary of your extension here! -->
+
 
 +
Sort of like a dollmaker/dressup game, minus the game. Admins must define layer images for use that perfeclty align (same image size and position) or the stacking will not work. Users can pick between options and color them in (if intended). Users can merge the final design and download it for currency/item, or this can be disabled and just used as an interactive trait viewer or something. It can get as complex as you make it, but due to image manipulations may sometimes be slow if you do a LOT.
 +
 
 
== Installation ==
 
== Installation ==
<!-- Describe installation. Include any requirements (such as packages), necessary commands, etc. -->
+
* pull & deal with merge conflicts
 +
* <code>php artisan migrate</code>
 +
* <code>php artisan optimize</code> x2
 +
* <code>php artisan update-extension-tracker</code>
 +
 
 
== Configuration ==
 
== Configuration ==
<!-- Is any configuration necessary? Describe it here! -->
+
Nothing should be needed, it's all editable via admin panel.
 +
 
 
== Usage ==
 
== Usage ==
<!-- Is there anything users should know about using your extension? -->
+
Once you ran all the usual commands, you will have a 'character creators' under data in the admin panel. Here, you can make new character creators. There is a lot of layering going on here so I will try explain the basic logic:
 +
 
 +
* Character Creator: the creator itself, what is it for? Description name and image that show on the index.
 +
* Layer Group: Defines what users can change, eg. body/eyes/horns/wings/tails/bangs/back hair etc
 +
* Layer Option: An option users can pick within a group, eg. small horns, big horns, long horns etc
 +
* Layer: 1-X layers make up an option, this will in the simplest case be one line layer, if they should be colorable it will be a line layer and a base color layer, but it can also have multiple base color layers or detail layers (imagine markings on top)
 +
 
 +
Layers come in three types: line, color, detail.
 +
 
 +
* line: the lineart, or your artwork that should not be colorable by the user.
 +
* color: the base color, in perfect white RGB 255,255,255. Can be colored by the user. Can be multiple for one line layer, eg. an eye has a color layer for sclera and one for the iris
 +
* detail: all detail layers will appear as a choice for the user, and should be used for something like different markings. Only one detail layer will be active at a time, and they should be layered on top of the base color layers.
 +
 
 +
It's probably easiest to play around with it and see how it works!
 +
 
 
== Troubleshooting ==
 
== Troubleshooting ==
<!-- Are there known issues or errors that require user action? Who should they contact, and where, for support? -->
+
We are never 100% safe from those pesky bugs. If you find something, feel free to contact me- I am cylunny on discord or toyhou.se!
 +
 
 
== Images ==
 
== Images ==
<!-- Do you have any images to show what it looks like in action? -->
+
https://imgur.com/a/s4qML0P
 +
 
 
== See Also ==
 
== See Also ==
<!-- Any relevant other pages. You may consider linking to related extensions, for instance. -->
+
If this extension helped you, feel free to support me on [https://ko-fi.com/cylunny Kofi]!
 
 

Latest revision as of 03:43, 10 October 2024

Character Creator
Description Create characters similar to dollmakers from your own art!
Author(s) Cylunny
Status testing
Github extension/character-creator
LK Version 2.1.7
Contains a Migration






Sort of like a dollmaker/dressup game, minus the game. Admins must define layer images for use that perfeclty align (same image size and position) or the stacking will not work. Users can pick between options and color them in (if intended). Users can merge the final design and download it for currency/item, or this can be disabled and just used as an interactive trait viewer or something. It can get as complex as you make it, but due to image manipulations may sometimes be slow if you do a LOT.

Installation

  • pull & deal with merge conflicts
  • php artisan migrate
  • php artisan optimize x2
  • php artisan update-extension-tracker

Configuration

Nothing should be needed, it's all editable via admin panel.

Usage

Once you ran all the usual commands, you will have a 'character creators' under data in the admin panel. Here, you can make new character creators. There is a lot of layering going on here so I will try explain the basic logic:

  • Character Creator: the creator itself, what is it for? Description name and image that show on the index.
  • Layer Group: Defines what users can change, eg. body/eyes/horns/wings/tails/bangs/back hair etc
  • Layer Option: An option users can pick within a group, eg. small horns, big horns, long horns etc
  • Layer: 1-X layers make up an option, this will in the simplest case be one line layer, if they should be colorable it will be a line layer and a base color layer, but it can also have multiple base color layers or detail layers (imagine markings on top)

Layers come in three types: line, color, detail.

  • line: the lineart, or your artwork that should not be colorable by the user.
  • color: the base color, in perfect white RGB 255,255,255. Can be colored by the user. Can be multiple for one line layer, eg. an eye has a color layer for sclera and one for the iris
  • detail: all detail layers will appear as a choice for the user, and should be used for something like different markings. Only one detail layer will be active at a time, and they should be layered on top of the base color layers.

It's probably easiest to play around with it and see how it works!

Troubleshooting

We are never 100% safe from those pesky bugs. If you find something, feel free to contact me- I am cylunny on discord or toyhou.se!

Images

https://imgur.com/a/s4qML0P

See Also

If this extension helped you, feel free to support me on Kofi!