GithubHelp home page GithubHelp logo

pintthedragon / images Goto Github PK

View Code? Open in Web Editor NEW
6.0 1.0 3.0 75 KB

An EXILED plugin to let you display images ingame

License: Apache License 2.0

C# 100.00%
intercom broadcasts hints scpsl scpsl-server scpsl-plugin exiled exiled-plugin plugin csharp

images's Introduction

Images

Images is a plugin and library that allows you to put images into SCPSL. You can put images into the intercom, hints, and broadcasts. If you want to put images into serverinfo, use this converter.

Installation

To install this plugin, download the latest release, then put Images.dll into your plugins folder and System.Drawing.dll into your dependencies folder (which is inside of your Plugins folder). You need to also have Mono installed or else you will run into errors.

Usage

To use Images, you have to first configure your images. Then, you can use them in any of the below commands, replacing the image name with the name of your image (the name you set it to in the config, not the file name).

Limitations

Currently, the maximum uncompressed image size is 27x27 for hints and intercom, and around 7x7 for broadcasts. While images larger than 27x27 will be automatically compressed, images in broadcasts are more limited. If an image exceeds 27x27, it will be compressed so that it's small enough to function in hints and the intercom. This compression will cause it to lose quality, but will allow you to use larger images.

Commands

Here are all of the commands that Images has:

  • iintercom <image name> - images.iintercom - Puts an image on the intercom
  • ibc <duration> <image name> - images.ibc - Broadcasts an image to every player
  • ihint <duration> <image name> - images.ihint - Shows a hint with an image to every player

Configuration

To add an image to Images, you need to first add it to the configuration. In your EXILED config file, find the Images section. To add images, you need to add your image under the Images config option. Here's what an image might look like:

- name: example2
  location: https://pint.cloud/img2txt/smallimg.png
  isURL: true
  scale: 26
  fps: auto
  precache: true

The first item (name) is the name you want the image to be set to. This will be the name that is used in your commands.

The second item (location) is where your image is located. This can be either a file path or a URL.

The third item (isURL) is whether or not your image's location is a URL. If it is, set this to true, otherwise false.

Optional: The fourth item (scale) is the scale of an image. You can set this manually and try to find what works for you, or you can set it to auto to have the plugin determine it for you.

Optional: The fifth item (fps) is the fps of the image. If your image is not animated, you don't need to worry about this.

Optional: The sixth item (precache) is whether or not to the image should be automatically converted and cached. Setting this to true can help increase performance for the first loop of an image (or if it is not animated, the load time).

Once you add your image to the config, you can use it in anywhere you can put an image into.

images's People

Contributors

pintthedragon avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

images's Issues

Hints don't work well

For some reason, hints need to be maxed at 2.5 fps and freeze when trying to loop a gif.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.