ExpandFonts Docs
Getting Started
ExpandFont is a server-side plugin made for Minecraft. It utilizes PlaceholderAPI to allow you to use custom resource pack fonts in your placeholders!
For more detailed information and updates, please visit the ExpandFont GitHub repository.
Installation
1. Begin by navigating to your server's panel. (Pterodactyl Panel, Pelican Panel, etc.,)
2. Download the latest version of ExpandFont by download the `expandfont.jar`repo.
3. After downloading, place the jar file inside your plugins directory on your server.
4. Start up your server, and your good to go!
How to Use
1. Create Custom Placeholders:
ExpandFont allows you to use custom fonts from your resource pack in your placeholders. For example:
Placeholder: %expandfont_customfont:example_text%
Output: 𝐄𝐱𝐚𝐦𝐩𝐥𝐞 𝐓𝐞𝐱𝐭
2. Test Your Placeholders:
Use the following command to preview how your placeholder will render in-game:
/expandfont [FONT] [PLACEHOLDER]
3. Leverage Resource Pack Fonts:
Ensure your resource pack includes the custom fonts required for your placeholders. Without the proper font files, placeholders may not render correctly.
Follow these steps to enhance your Minecraft server experience with visually stunning placeholders powered by ExpandFont!
FAQ
What is ExpandFont?
+
A: ExpandFont is a PlaceholderAPI expansion plugin developed by Chest Solutions. It allows users to utilize custom resource pack fonts within placeholders, enabling the display of text in various styles such as small caps or bold.
Is ExpandFont stable for use?
+
A: ExpandFont is currently under development and may not be stable. Users are advised to exercise caution when using this plugin.
What is ExpandFont?
+
A: ExpandFont is a PlaceholderAPI expansion plugin developed by Chest Solutions. It allows users to utilize custom resource pack fonts within placeholders, enabling the display of text in various styles such as small caps or bold.
Are there plans for future features in ExpandFont?
+
A: We have plans to create methods for using built-in fonts like "Small-Caps" or "Bold" in future updates.
Troubleshooting
Why are my placeholders not displaying correctly?
+
A: If your placeholders are not displaying as expected, ensure that your custom resource pack containing the necessary font is properly loaded and active on the client. Double-check the placeholder syntax to ensure there are no typos in the font or placeholder names. Additionally, verify that PlaceholderAPI is installed and functioning correctly on your server. Finally, confirm that ExpandFont is installed and loaded without any errors during server startup.
Why do my placeholders show as plain text instead of formatted text?
+
A: This issue often occurs if your resource pack is not enabled or has not been downloaded by the client. Ensure that the resource pack URL is valid and properly configured. Another potential cause is that the font file in your resource pack does not include the style referenced by the placeholder. Open your resource pack’s `font.json` file to confirm that the necessary styles and characters are defined.
The plugin isn’t working after installation. How do I fix this?
+
A: If ExpandFont isn’t working as expected after installation, check your server logs for any errors related to the plugin during startup. Confirm that you are using the correct version of PlaceholderAPI and ensure it is compatible with your server version. You should also verify that ExpandFont is listed as an active expansion by running the `/papi list` command. If it is not listed, get help in the discord server and have them help resolve the issue.
I made changes to my resource pack, but they’re not reflected in-game.
+
A: If changes to your resource pack aren’t showing up in the game, start by clearing your client-side resource pack cache and reapplying the resource pack. Restarting the Minecraft client can also help ensure that the updated resource pack is loaded. Additionally, confirm that the edits were made to the correct resource pack currently in use by the client.
My custom fonts don’t appear in the game.
+
A: When custom fonts fail to appear in the game, it’s important to verify that the font file in your resource pack is correctly formatted. The font configuration should adhere to Minecraft’s specifications, and all characters used in your placeholders must be defined in the font file. Review the resource pack’s configuration carefully to ensure compatibility.
Advanced Features
Custom Placeholder Integration
ExpandFont allows you to create advanced placeholders by integrating custom resource pack fonts with dynamic values. You can combine text styles, such as small caps or bold, with server-side data like player counts or ranks. For example, a placeholder like `%expandfont_MyFont:small_caps_online%` can dynamically render the number of online players in small caps, styled exactly as defined in your custom font file. This feature enables you to add highly customized and visually appealing text displays to your server.
Multiple Font Styles in One Placeholder
With ExpandFont, you can seamlessly use multiple font styles within a single placeholder to create visually complex outputs. By chaining or nesting placeholder references, you can mix and match different font styles in a single line of text. For example, `%expandfont_MyFont:small_caps_hello%` `%expandfont_MyFont:bold_world%` will display "hello" in small caps and "world" in bold, allowing you to design unique and detailed text displays tailored to your server’s needs. This feature is particularly useful for creating banners, announcements, or interactive menus with distinctive font styles.