PictureLogin-R2

PictureLogin

<div align="center"> <div align="center"> <img src=""> </div> </div>

Introduction

PictureLogin is an enhanced Spigot/Bukkit plugin that displays custom messages with player skin images when players log into the server. This fork extends the original plugin with numerous additional features and improved performance.

Original Author: Nathan Glover (NathanG/ItsNathanG)

Fork Author: Lythrilla

Features

Core Features

* Display player skin ASCII art in the chat bar * Customizable welcome messages * Special messages for first-time joiners * Leave server messages * PlaceholderAPI integration * AuthMe integration

Enhanced Features

Multi-language Support* - Built-in support for multiple languages (English and Chinese included by default) Online Preview* - Preview login messages in-game without reconnecting Permission-based Messages* - Assign different login messages based on permission groups Player-specific Messages* - Set unique messages for specific players Command Control* - Enable/disable features through commands MiniMessage Support* - Use Adventure API's MiniMessage format for modern text formatting SkinRestorer Integration* - Correctly display custom skins from SkinRestorer Account Type Detection* - Automatically detect and handle premium/offline Minecraft accounts PAPI Variables* - Support for avatar PlaceholderAPI variables Legacy Color Support* - Backward compatibility with traditional color codes

Requirements

* Java 17 or higher * Spigot/Paper 1.20 or higher * (Optional) PlaceholderAPI - For using variables from other plugins * (Optional) AuthMe - For login integration * (Optional) SkinRestorer - For custom skin support * (Optional) PremiumVanish - For player invisibility compatibility

Installation

1. Download the latest JAR file from [Releases](https://github.com/Lythrilla/PictureLogin/releases) 2. Place the JAR file in your server's plugins folder 3. Restart the server or reload the plugin 4. Configure the plugin in plugins/PictureLogin/config.yml

Permissions

Permission | Description --- | --- picturelogin.use | Allows using PictureLogin commands (Default: Everyone) picturelogin.show | Allows players to see login messages (Default: Everyone) picturelogin.reload | Allows reloading PictureLogin plugin configuration (Default: OP) picturelogin.language | Allows changing plugin language (Default: OP) picturelogin.debug | Allows using debug commands (Default: OP) picturelogin.group.vip | Custom message permission for VIP players (Default: No) picturelogin.group.admin | Custom message permission for admins (Default: OP) picturelogin.effect.rainbow | Rainbow effect permission (Default: No) picturelogin.effect.gradient | Gradient effect permission (Default: No)

Commands

Command | Description --- | --- /picturelogin reload | Reload configuration /picturelogin language [lang] | View or change language /picturelogin version | Display version information /picturelogin help | Display help information /picturelogin debug <login\|leave\|firstjoin\|all> [global\|user\|perm] [name] | Debug different types of messages Aliases: /piclogin, /plogin, /pl

Multi-language Support

This plugin supports a multi-language system, with language files located in the plugins/PictureLogin/lang/ directory. The following languages are provided by default: * English (en_US.yml) * Chinese (zh_CN.yml) You can copy these files and create your own translations.

PlaceholderAPI Variables

This plugin provides the following PlaceholderAPI variables for displaying player avatars in other plugins:

Current Player Avatar Variables

%picturelogin_avatar_1% - Current player avatar line 1
%picturelogin_avatar_2% - Current player avatar line 2
%picturelogin_avatar_3% - Current player avatar line 3
%picturelogin_avatar_4% - Current player avatar line 4

Other Player Avatar Variables

%picturelogin_avatar_1_<player>% - Avatar line 1 of specified player
%picturelogin_avatar_2_<player>% - Avatar line 2 of specified player
%picturelogin_avatar_3_<player>% - Avatar line 3 of specified player
%picturelogin_avatar_4_<player>% - Avatar line 4 of specified player

Message Formatting

This plugin supports multiple text formatting methods:

MiniMessage Format

<gradient:red:blue>This is a gradient text</gradient>
<rainbow>This is a rainbow text</rainbow>
<color:gold>This is a gold text</color>

Legacy Color Codes

&6This is a gold text
&bThis is a aqua text

Configuration

The plugin configuration is located at plugins/PictureLogin/config.yml. You can customize: * Message formats * Avatar appearance * Effect settings * Permission group messages * Player-specific messages

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. <div align="center"> [GitHub](https://github.com/Lythrilla/PictureLogin) | [issue](https://github.com/Lythrilla/PictureLogin/issues) | [oldest](https://github.com/ItsNathanG/PictureLogin) </div>