===========
Sign Copier
===========

The **Sign Copier** mechanic allows you to copy and paste signs, as well as modify them.

Usage
=====

To use the sign copier, right click the sign you want to copy with flint, then punch the sign you want to paste the text onto. You can paste to as many signs as you would like.

Editing Text
------------

To edit text, you can use the ``/signcopy edit`` commands. The syntax is ``/signcopy edit <line> <text>``. This edits the currently copied sign.

In order to edit text with spaces, just surround it with quotes (""). Eg, ``/signcopy edit 1 "This is a sign"``.

Remove the copied sign
----------------------

To get rid of any currently copied signs, you can use the ``/signcopy clear`` command.

Configuration
=============

============== =================================================================== =================
Node           Comment                                                             Default
============== =================================================================== =================
item           The item for the sign copier tool.                                  minecraft:flint
copy-color     If the sign copier should also copy the dyed color of the sign.     true
copy-glowing   If the sign copier should also copy the glowing status of the sign. true
============== =================================================================== =================

Permissions
===========

+-------------------------------+---------------------------------------------------+
|  Permission Node              |  Effect                                           |
+===============================+===================================================+
|  craftbook.signcopier.use     |  Allows use of the Sign Copier tool.              |
+-------------------------------+---------------------------------------------------+
|  craftbook.signcopier.edit    |  Allows the user to use the text editing feature. |
+-------------------------------+---------------------------------------------------+
|  craftbook.signcopier.clear   |  Allows the user to clear their selected sign.    |
+-------------------------------+---------------------------------------------------+

Commands
========
.. contents::
    :local:

.. note::

    Arguments enclosed in ``[ ]`` are optional, those enclosed in ``< >`` are required.

SignCopier
~~~~~~~~~~
.. raw:: html

    <span id="command-/signedit"></span>

.. topic:: ``/signedit``(or ``/edsign``, ``/signcopy``)
    :class: command-topic

.. csv-table::
  :widths: 8, 15

        **Usage**,"``/signedit <edit|clear>``"
        **Description**,"CraftBook SignCopier Commands"

.. raw:: html

    <span id="command-/signedit-edit"></span>

.. topic:: ``/signedit edit``
    :class: command-topic

.. csv-table::
  :widths: 8, 15

        **Usage**,"``/signedit edit <piston.argument.line> <piston.argument.text...>``"
          ``<piston.argument.text...>``,"The text to use"
          ``<piston.argument.line>``,"The line to edit"
        **Description**,"Edits the copied sign."
        **Permissions**,"``craftbook.signcopier.edit``"

.. raw:: html

    <span id="command-/signedit-clear"></span>

.. topic:: ``/signedit clear``
    :class: command-topic

.. csv-table::
  :widths: 8, 15

        **Usage**,"``/signedit clear``"
        **Description**,"Clears the copied sign."
        **Permissions**,"``craftbook.signcopier.clear``"