Extensions:Character Foregrounds - Revision history

Camyza: /* Usage */

2025-11-24T00:04:39Z

Usage

Camyza: /* Usage */

2025-11-24T00:02:47Z

Usage

Camyza at 00:02, 24 November 2025

2025-11-24T00:02:05Z

Camyza: Created page with "{{Extensioninfobox|title=Character Foregrounds|desc=Adds layered foregrounds.|auth=Camyza, Frank (adjustments on original code), Preimpression |status=Testing|github={{Github|..."

2025-11-23T23:58:00Z

Created page with "{{Extensioninfobox|title=Character Foregrounds|desc=Adds layered foregrounds.|auth=Camyza, Frank (adjustments on original code), Preimpression |status=Testing|github={{Github|..."

New page

{{Extensioninfobox|title=Character Foregrounds|desc=Adds layered foregrounds.|auth=Camyza, Frank (adjustments on original code), Preimpression |status=Testing|github={{Github|user=Camyza|branch=extension/character-foregrounds-v3}}|LKVer=3.0.0|migration=no|package=no}}

{{Extensioninfobox|title=Character Foregrounds With Backgrounds|desc=Adds layered foregrounds with character backgrounds.|auth=Camyza, Frank (adjustments on original code), Preimpression |status=Testing|github={{Github|user=Camyza|branch=extension/character-backgrounds-foregrounds-v3}}|LKVer=3.0.0|migration=no|package=no}}

This extension adds cosmetic foregrounds in the form of item tags. Thanks to Uri for the base code and Frank for adjustments! I made two versions: one with only Foregrounds and one with Foregrounds and Backgrounds installed to make it painless to install [hoping!].

See the original character backgrounds extension:
[[Extensions:Character Backgrounds]]

{{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}}

== Installation ==

== Configuration ==

== Usage ==

== Troubleshooting ==

== Images ==

== See Also ==


== Installation ==
After pulling the branch and merging it in, run <pre>php artisan optimize</pre> and <pre>php artisan update-extension-tracker</pre>.

== Configuration ==

All items with this tag will need an image to be uploaded. This image needs to be transparent. It does not validate on file size, so you may wish to add that in yourself.

As each site's usage of this may differ, you may need to go into <pre>views/character/character.blade.php</pre> and <pre>views/character/_profile.blade.php</pre> to adjust anything necessary as far as html or css goes.

== Usage ==

It is *required* to create an Item Category that is specific for foregrounds. This category should be set to allow characters to hold them.

The foreground image needs to be transparent to show up. It does not actually edit any images. It uses the z-index property with Laravel's built in feature, $loop->index, to go through them. It will layer the background first (if you have any) and then the character image itself. So with that, it will be 0, and 1, and start with 2 and etc for the foregrounds. If you have none set for any foreground, it will not display anything on a character's page.

**I wasn't able to make these position-able**, so you will have to make sure the foreground images are the same size as the backgrounds + transparent. IF anyone is able to do this, please do make a PR as it would be a lovely addition for even more customization.

== Troubleshooting ==

If you need any help, ping me on Discord, Camyza. It's best to make a general-help channel in the LK Discord so that it won't get lost in my DMs.

== Images ==


== See Also ==
Support Uri!
https://ko-fi.com/preimpression

@@ Line 21: / Line 21: @@
 It is *required* to create an Item Category that is specific for foregrounds. This category should be set to allow characters to hold them.
-The foreground image needs to be transparent to show up.  It does not actually edit any images.  It uses the z-index property with Laravel's built in feature, $loop->index, to go through them.  It will layer the background first (if you have any) and then the character image itself.  So with that, it will be 0, and 1, and start with 2 and etc for the foregrounds.  If you have none set for any foreground, it will not display anything on a character's page.
+The foreground image needs to be transparent to show up.  It does not actually edit any images.  It uses the z-index property with Laravel's built in feature, $loop->index, to go through them. If you have none set for any foreground, it will not display anything on a character's page.
 I wasn't able to make these position-able, so you will have to make sure the foreground images are the same size as the backgrounds + transparent.  IF anyone is able to do this, please do make a PR as it would be a lovely addition for even more customization.

@@ Line 23: / Line 23: @@
 The foreground image needs to be transparent to show up.  It does not actually edit any images.  It uses the z-index property with Laravel's built in feature, $loop->index, to go through them.  It will layer the background first (if you have any) and then the character image itself.  So with that, it will be 0, and 1, and start with 2 and etc for the foregrounds.  If you have none set for any foreground, it will not display anything on a character's page.
-**I wasn't able to make these position-able**, so you will have to make sure the foreground images are the same size as the backgrounds + transparent.  IF anyone is able to do this, please do make a PR as it would be a lovely addition for even more customization.
+I wasn't able to make these position-able, so you will have to make sure the foreground images are the same size as the backgrounds + transparent.  IF anyone is able to do this, please do make a PR as it would be a lovely addition for even more customization.
 == Troubleshooting ==

@@ Line 7: / Line 7: @@
 See the original character backgrounds extension:
 [[Extensions:Character Backgrounds]]
 == Installation ==