Fly a custom object consisting of carpet, chair, lantern, and lock

Supported Games

Flying Carpet allows an enabled user to spawn and ride their own flying machine. The carpet consists of a floor rug, chair, code lock, and lantern. The lantern is used to take off and land.

There are two modes of operation depending on the permission granted to the user. The default mode requires low-grade fuel in the lantern in order to fly. The unlimited mode does not require fuel.

For the default mode, the user will receive notification via chat message as well as an audible water pump sound when fuel is low (1 low grade fuel). Each unit of low grade fuel gives you 10 minutes of flying time, which is the same rate of usage as the standard lantern. When you run out of fuel, the carpet will land itself immediately.

Permissions

  • flyingcarpet.use -- Allows player to spawn and fly a carpet using low grade fuel
  • flyingcarpet.unlimited -- Removes the fuel requirement

It is suggested that you create groups for each mode:

  • oxide.group add fc
  • oxide.group add fcunlimited

Then, add the associated permissions to each group:

  • oxide.grant group fc flyingcarpet.use
  • oxide.grant group fcunlimited flyingcarpet.unlimited

Finally, add users to each group as desired:

  • oxide.usergroup add rfc1920 fc

Of course, you could grant, for example, unlimited use to all players:

  • oxide.grant group default fc.unlimited

Chat Commands

  • /fc -- Spawn a flying carpet
  • /fcd -- Despawn a flying carpet (must be within 10 meters of the carpet)
  • /fcc -- List the current number of carpets (Only useful if limit set higher than 1 per user)
  • /fchelp -- List the available commands (above)

Configuration

{
    "ChairSkinID : ": 943293895,
    "Deploy - Enable limited FlyingCarpets per person : ": true,
    "Deploy - Limit of Carpets players can build : ": 1,
    "Minimum Flight Altitude : ": 5.0,
    "Require Fuel to Operate : ": true,
    "RugSkinID : ": 871503616,
    "Speed - Normal Flight Speed is : ": 12.0,
    "Speed - Sprint Flight Speed is : ": 25.0
}

Note that that owner/admin can customize the skins for both the chair and the rug, set global fuel requirements and flying speed, and limit the number of carpets for each player (highly recommended).

You could set "Require Fuel to Operate : " to false, but it is recommended that you leave this setting true and use the flyingcarpet.unlimited permission instead if you want to remove the fuel requirement.

Flight School

  1. Type /fc to spawn a carpet.
  2. Jump on the carpet and set a code on the lock. Unlock after setting the code.
  3. Add low-grade fuel to the lantern (if running in default mode).
  4. Sit in the chair.
  5. Aim at the lantern and press 'E' to take off!
  6. From here on use, WASD, Shift (sprint), spacebar (up), and Ctrl (down) to fly.
  7. When ready to land, point at the lantern and press E again.
  8. Once on the ground, use the spacebar to dismount.
  9. Lock the carpet using the code lock to prevent others from using it.
  10. Use /fcd while standing next to the carpet to destroy it.

Localization

{
    "helptext1": "Flying Carpet instructions:",
    "helptext2": "  type /fc to spawn a Flying Carpet",
    "helptext3": "  type /fcd to destroy your flyingcarpet.",
    "helptext4": "  type /fcc to show a count of your carpets",
    "notauthorized": "You don't have permission to do that !!",
    "notflyingcarpet": "You are not piloting a flying carpet !!",
    "maxcarpets": "You have reached the maximum allowed carpets",
    "landingcarpet": "Carpet landing sequence started !!",
    "risingcarpet": "Carpet takeoff sequence started !!",
    "carpetlocked": "You must unlock the Carpet first !!",
    "carpetspawned": "Flying Carpet spawned!  Don't forget to lock it !!",
    "carpetfuel": "You will need fuel to fly.  Do not start without fuel !!",
    "carpetnofuel": "You have been granted unlimited fly time, no fuel required !!",
    "nofuel": "You're out of fuel !!",
    "lowfuel": "You're low on fuel !!",
    "nocarpets": "You have no Carpets",
    "currcarpets": "Current Carpets : {0}"
}

Preview

Known Issues

  1. Lantern can be started or stopped by another player, which can cause the lantern cycle to be out of sync (off while flying).

Credits

  • rfc1920, the original author of this plugin
MIT License

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

13.2K downloads
87 watchers

funflycarpetunmaintained