Repository files navigation

CSkull is a plugin for the Minecraft: Bedrock Edition server softwarePocketMine-MP which aims to implement vanilla-like player skulls, the way they exist in Minecraft: Java Edition.

• Proper block collision and breaking
  Many already existing plugins which implemented player skulls, used entities only, which gave the skulls their proper skin but did not give their skulls any collision.
  CSkull implements collision by spawning the entity on top of the normal skull block, which makes both the correct block collision, as well as block-breaking possible.
• Skin data always accessible
  Because we store the skin data of every player, that joined your server, in a database, it is possible to get the skull of a player, which is not online.
• Possibility of hiding skulls
  As every skull is a unique entity, the frames per second of a player's game are likely to drop when being forced to render a big number of skull entities. So, if that is the case or the player just does not want to see those skulls, he can disable them by typing a command. If a player decides to hide the entities, they are not just made invisible but will not even be spawned to him at all. The player will only see the steve skull block below the entity, so that he can see, that there possibly was an entity there.
• Queuing skull entity spawn
  As it can lag a player's client if too many entities are spawned at once, this plugin provides the possibility to only spawn a specific amount of skull entities to a player in the same tick. Read more about ithere.
• No deletion of skulls when plugin fails to load
  As we do not store the data in the skull entities which we would save in the chunk, but instead we store them in a database, there will not be any problems when a chunk is loaded without the plugin being enabled because no data is lost. There simply will not be any skull entities spawned if that is the case.
  Unless the skull block is not broken without the plugin being not loaded or the database being deleted, there should not be any problems with deleted skulls.
• Removing the plugin without problems
  Normally, when you would load a chunk that has unkown entities, e.g. from a removed plugin, in it, your console would be spammed with warnings that those entities were deleted.
  Since, we do not store the skull entities on the disk, you can remove the plugin from your server without noticing it. (This plugin only handles the spawn of the skull entities, not of the skull block. So when you remove the plugin, the steve skull blocks, that were under the entities, will remain in your world.)
• /skull command cooldown
  It may be in the interest of some servers to not let their players get unlimited amounts of skulls. By setting specific permission for their players, they can decide the cooldown a player should have on performing the /skull command. For a list of the permissions, lookhere.
• Language
  Although the plugin's displayed messages are in English, you can customize that file to your need by modifying thelanguage.ini file in theplugin_data folder of this plugin.
  There, you can also change the name and lore of the skull item.

Customizations can be done in theconfig.yml in the plugin'splugin_data folder:

• skullEntity.spawn.delay:1
  Define the delay in ticks between the spawn or despawn interval of skull entities for players.
• skullEntity.spawn.maxPerTick:2
  Define how many skull entities can be spawned to a player or despawned from it in the same tick.
  IfskullEntity.spawn.delay is set to 0, this configuration will be ignored.
• database
  Change the settings for the database this plugin will use. This is the default format provided bylibasynql.

• FIXED: Experience orbs are being attracted by our skull entities which should not happen.
  This is due to the way PMMP handles these attractions: experience orbs are attracted to all human entities and therefore also our skull entities. But since we can not intervene in that by listening to an event, there is no easy way to fix that currently. This problem is already referenced in anissue.
  We would have two solutions: overwrite theExperienceOrb class to implement our own entity search in theExperienceOrb::entityBaseTick() method or let theSkullEntity class extend theEntity instead of theHuman class and implement the skin handling, etc. ourselves. Both solutions are kind of complicated and in my eyes not worth the effort at the moment, just for them to get ruled out by a far easier way when the issue is resolved.
  UPDATE: The issue was resolved with thePR and merged into PocketMine-MP 4.1.0. If this minor version releases, we can resolve this issue by adding the following to our SkullEntity class:
  

  publicfunctioninitEntity(CompoundTag$nbt) :void {parent::initEntity($nbt);// Disables that experience orbs are attracted to skull entities.$this->xpManager->setCanAttractXpOrbs(false);}