Skip to content

Commit 7eec0f1

Browse files
authored
docs: README (#22)
1 parent ad7a7b7 commit 7eec0f1

File tree

3 files changed

+71
-24
lines changed

3 files changed

+71
-24
lines changed

README.md

Lines changed: 59 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,25 +8,73 @@
88
[![Discord](https://img.shields.io/discord/1253434107656933447?logo=discord&label=Discord)](https://discord.gg/xWGh4GskG5)
99
[![ko-fi](https://img.shields.io/badge/Support%20on-ko--fi-ff5e5b?logo=ko-fi)](https://ko-fi.com/T6T8WZD0W)
1010

11-
plenticons is a pack of icons to use with custom nodes in the [Godot] editor.
11+
A pack of icons to use with custom nodes in the [Godot] editor. Or wherever
12+
else!
13+
14+
## Features
15+
16+
* ![plus](./icons/2d/plus.svg) 50+ icons of various categories
17+
* ![chest](./icons/objects/chest.svg) Each icon comes in multiple variants
18+
* ![heart](./icons/creatures/heart-full.svg) Licensed as CC0 - take it and use it
19+
* ![globe](./icons/objects/globe.svg) [Dedicated site] for browsing
20+
* ![check](./icons/2d/checkmark.svg) Available for HiDPI displays too
21+
* ![lightning](./icons/objects/lightning.svg) Optimized for size
22+
23+
## Overview
1224

1325
Often, when working on projects, it would be nice to have some custom icons for
1426
specific nodes, but finishing the project is a big enough task in itself.
1527
Making custom icons for different nodes is often overkill, as it adds effort,
1628
but doesn't effect the finished game at all.
1729

18-
## Variations
30+
This is where *plenticons* saves the day! Providing many different icons,
31+
instead of having to make them on your own, just pick and choose which one fits
32+
your node!
33+
34+
Each icon comes in multiple color variations, using Godot's standard node
35+
colors for your color coding pleasure! White and black variants are also
36+
included, to be used as masks, or tinting.
37+
38+
And with its permissive license, *plenticons* can be used outside of the Godot
39+
editor, in your games, applications, wherever you deem fit!
40+
41+
## Install
42+
43+
Depending on your preference, you may:
44+
45+
* Download from the Godot Asset Library, searching for *plenticons*
46+
* Download the latest [release] from Github
47+
48+
## Usage
49+
50+
After importing the addon to your Godot project, use the `@icon` annotation on
51+
your custom scripts, e.g.:
52+
53+
```gdscript
54+
@icon("res://addons/plenticons/icons/16x/foxs-sake/plenticons-yellow.png")
55+
```
56+
57+
For the HiDPI version, replace `16x` with `64x-hidpi` in the path:
58+
59+
```gdscript
60+
@icon("res://addons/plenticons/icons/64x-hidpi/foxs-sake/plenticons-yellow.png")
61+
```
62+
63+
To pick an icon visually, browsing the [site] and clicking on an icon will show
64+
the corresponding code snippet. Clicking on the snippet will automatically copy
65+
it to the clipboard.
66+
67+
## Support
68+
69+
If you've found *plenticons* useful, feel free to fund us on ko-fi:
1970

20-
Each icon comes in multiple color variations:
71+
[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/T6T8WZD0W)
2172

22-
* Gray ( `#e0e0e0` )
23-
* Red ( `#fc7f7f` )
24-
* Blue ( `#8da5f3` )
25-
* Green ( `#8eef97` )
26-
* Yellow ( `#ffca5f` )
73+
## License
2774

28-
Variations are generated by a script, and then optimized by [svgo], before
29-
packing.
75+
*plenticons* is under the [CC0 1.0 license](LICENSE).
3076

77+
[Dedicated site]: https://foxssake.github.io/plenticons/
3178
[Godot]: https://godotengine.org/
32-
[svgo]: https://svgo.dev/
79+
[release]: https://github.com/foxssake/plenticons/releases
80+
[site]: https://foxssake.github.io/plenticons/

addons/plenticons/plugin.cfg

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,5 +3,5 @@
33
name="plenticons"
44
description="A library of icons for your custom nodes!"
55
author="Tamás Gálffy"
6-
version="0.10.1"
6+
version="0.10.2"
77
script="plenticons.gd"

site/index.html

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -12,18 +12,17 @@
1212
<body>
1313
<h1><img src="icons/foxs-sake/plenticons-yellow.svg" />lenticons</h1>
1414

15-
<p>
16-
plenticons is a library of icons to use with your custom scripts.
17-
</p>
18-
<p>
19-
When building games in Godot, it would often be nice to have different
20-
icons for custom nodes, to make it easier to see what's going on at a
21-
glance.
22-
</p>
23-
<p>
24-
This is where plenticons save the day! This library provides icons ready to
25-
use with your custom nodes!
26-
</p>
15+
<p>A pack of icons to use with custom nodes in the <a href="https://godotengine.org/">Godot</a> editor. Or wherever else!</p>
16+
17+
<h2 id="features">Features</h2>
18+
<ul>
19+
<li><img src="./icons/2d/plus-yellow.svg" alt="plus"> 50+ icons of various categories</li>
20+
<li><img src="./icons/objects/chest-yellow.svg" alt="chest"> Each icon comes in multiple variants</li>
21+
<li><img src="./icons/creatures/heart-full-yellow.svg" alt="heart"> Licensed as CC0 - take it and use it</li>
22+
<li><img src="./icons/objects/globe-yellow.svg" alt="globe"> <a href="https://foxssake.github.io/plenticons/">Dedicated site</a> for browsing</li>
23+
<li><img src="./icons/2d/checkmark-yellow.svg" alt="check"> Available for HiDPI displays too</li>
24+
<li><img src="./icons/objects/lightning-yellow.svg" alt="lightning"> Optimized for size</li>
25+
</ul>
2726

2827
<div class="toolbar">
2928
<variant-picker></variant-picker>

0 commit comments

Comments
 (0)