Portal Gun is back. Here’s what’s new, and what’s to come.

Hey all!

So I don’t know if you caught it but I released Portal Gun for Minecraft 1.10.2 yesterday, but I didn’t get round to writing about what’s new. This is going to be a bit of a long post as I write about what’s new with Portal Guns and what’s planned for the future, and it will get a little technical. A bunch of screenshots I’ll be showing here will be from the development version so you get a little bit of insight on the process as well.


The image used to announce the release of Portal Gun.

So I’m sure a lot of you have noticed, but you can see through the portals again. This work is a combination of what you guys saw in Doors and what you guys saw in Blocksteps. Code changes in Minecraft 1.8 however, essentially meant I had to rewrite most of the code that was from Doors again anyways.

However, as these see through portals are what you would call a “live render”, your FPS will, effectively, be reduced by ~40-60% as what I am doing is essentially moving the camera and re-rendering the entire scene, with extra bits and pieces to make sure the render looks right. But on the bright side, you can see portals in portals!

Recursive rendering works. But of course, FPS will tank. In-dev GraviPortalGun also seen here.

Portals also now have a new fancy portal border render made by amadornes, who helped make the shader that we’re using and some of the background code in how portals actually work.

To try and accommodate for everyone’s various setups, there are a bunch of configs available for you to tweak. In the future there may be more added as I try and improve the performance or reduce the load on players. You can read the tooltips on the settings themselves to figure out what they do.

Go to: Mods -> iChunUtil or PortalGun -> Config, and an in-game config editor like this should show up.

Next up on the list, say hi to the new portal gun model by RazzleberryFox. You can already see it in the first image, but it also animates (to a degree) when you’re firing portals and grabbing blocks. However, the animation was rushed (the model was literally added and animated a day or two before release), and may be subject to change, but here, have some fancy in-dev shots of me getting the model in-game.

That’s a really weird looking lightsaber… Oh wait a new mod idea! (I’m joking)

I have made a monster. Say hi to the many-clawed portal-gun.

(Also known as the monstrosogun, portal shader in this image was still WIP)

Also to note, the portal gun core and indicator glows in the dark.

Mmm… electrical arches.

Another thing to note is that portals will also render their outlines if they’re obstructed and you’re holding the portal gun of that type.

I totally did not just place that block of grass and chicken just to show off the outlines.

That’s pretty much all I have to say for aesthetics. I do have to add that for all of them to work properly, (getting technical here!) Minecraft has to think that you can use framebuffers, and your graphics card should be able to support stencil buffers and shaders. Unless your computer is incredibly old (or, if you’re using integrated graphics potentially), most of you should be perfectly fine. If not, drop me a message somewhere and I’ll try and troubleshoot it with you.


Okay so for gameplay, the basic essentials hasn’t really changed. Shoot portal here, shoot portal there, speedy thing goes in, speedy thing goes out.

Ignore the round portal. I’ll explain that later

However, there is a new mechanic to portals. Portals now have collision around the portal. Gone are the days where you could touch a ghast (which is 4x4x4) against a 1×2 (width x height) portal and suddenly have it pop out on the other side. Entities have to physically enter the portal to be able to teleport through the portal. The same applies for players but due to an oversight (that I hope to fix in 1.11.2), I have to teleport the player sooner than other entities. It is very, very satisfying to fire portals on the ground now and watch entities drop into it 😉

Yes, your camera WILL roll when you go in through a portal in the ground/ceiling. Just imagine that you’re reorienting yourself after you came out of a portal sideways.

Half in, half out

I quite liked this picture actually. This was pretty much immediately after I finally got the entity renders within a portal working right. See next image.

Entities in the portal had to be special cased to be sure they rendered on the “other side”. If they weren’t, you’d see something like this.

Crafting, at the moment, still uses the same recipes. This is subject to change. There is something new I want to add later that I wasn’t able to put in due to time constraints. I will write about it in a bit. If you look at the tooltip for the portal gun you can kind of gather what I might be planning. Crafting a new portal gun will randomly create a channel for you with random colour allocations. Don’t like the colours? Keep crafting new portal guns. The “Global” portal guns, Chell, Atlas, P-body, can all be found in the creative inventory.

Yay for new textures/models?

That’s actually it for gameplay. It hasn’t really changed as much from the old mod, really. MC’s attack key for shooting left portal, MC’s use item key for shooting right portal, middle mouse to zoom, G for grab, R for reset, hold R and hit LMB/RMB for individual resets. (QWERTY layout).

What’s to come?

This is where it gets interesting. There will be a lot more text here rather than pictures. Trying to adapt a concept as gold as portals and the portalgun for MC survival is going to be hard. I have some ideas that I would like to share with you here first.

1×2 left, 5×5 right

For starters, portal guns are meant to be upgraded and their portals meant to be highly customizable. The rewrite was done with this in mind so most of the underlying structure is already there… There’s just no way to modify it yet. Firstly, portals will come in various shapes and sizes. I’m planning for the basic portal gun to start off as a simple 1×2 portal, upgradable in width and height individually up to 5×5.

Next up, if you didn’t catch it when I mentioned “Global” portal guns, portal guns are meant to be a personal object now. When you make a portal gun it will be assigned to you and you can apply/create a channel and choose your own colours. A portal gun made and configured by a specific person will only provide access to that specific channel. Global portal guns are essentially a set of channels that aren’t locked to any particular player and is meant to be shared between one another on servers. For now, when you craft a portal gun, you are allocated a random channel with a random colour and a paired colour on the opposite end of the colour hue spectrum. You should be able to change these in the future.

Speaking of crafting, I’m also targeting to make portal guns a mid-game item (because it can be upgraded over time), meaning the recipe will be changed to adjust for mid-game. Midgame here meaning vanilla of course, mod pack makers are welcome to change this recipe as they wish in the future and adjust the balance of it all. Feel free to drop me a message when the time comes on how you would like to discuss balance.

Grab strength is also going to be an upgradable feature. For now I’ve gone and given you the strongest grab capabilities of the portal gun, close to combating the gravity gun in functionality, actually.

In terms of the upgradable system. Portal guns and portals are likely to require fuel, and eventually upgradable to not require it. Though I understand some of you (myself included) might not like this change (you could say it’s not true to Portal lore), like I said, it is hard to try and adapt something like this for MC survival and to keep it somewhat balanced. A lot of the factors will be part of an upgradable system, fuel requirement, portal firing distance, portal upkeep/use, grab use, size, etc. I am, of course looking for feedback on this in the reddit post I’ll link below.

I’m also thinking of changing the animation of the portal gun and the portal projectile renders. Those were rushed to meet yesterday’s release.

That’s pretty much it for portal guns. Over time more elements of Portal and Portal 2 will be making a return as well, when I can get round to it. In fact, right now the mod uses Portal 2’s sounds rather than Portal 1’s (yes, there actually is a difference).

Soo… besides that, you might have seen mention of something called “World Portals” in the config screenshot earlier. What is that? It is a part of iChunUtil, and essentially, is what powers the portals in the mod. It does the rendering of another perspective, the teleportation, those sort of things. It basically permits illusions like this, this, and if tweaked properly, could be as powerful as this (note that this mod is discontinued). Devs, you can find the source code here. Temp branch, soon to be pushed to master.

Eventually, I will write a mod that will allow people to take full control of World Portals. I could see this really being a very interesting and powerful concept to play around with in the future but that’s for a different time.

Known issues

  • Anything reported here.
  • Crashing on dedicated servers.
  • Incompatibility with foamfix, codechickenlib.
  • You can’t use portals or see through them over long distances. (I think)
  • Lag when you pair a set of portals.
  • The shader renders have bad z-fighting (#BlameAma)
  • Parts of the world will not render if there is camera roll involvement.
  • You can’t grab entities through portals and there’s no interaction with Gravity Gun yet.
  • You can’t shoot portals through iron grills.
  • We’re lacking a lot of aesthetics and config options as well.
  • Dispensers do not fire portals when triggered.
  • Fancy Portals config does not work.

Final note

This mod took an excruciating amount of time to rewrite. Part of it was already done last year, as some of you may remember. Unfortunately, I got burnt out working on it and shelved it. About a month ago I took it out and blew the dust off it and the result of continuing that work is what you see out now. Personally, I feel like I spent more time on it over the last month than I did last year.

Both World Portals and Portal Gun are not easy mods to write. As I stated yesterday, I felt that this release was not up to my usual standard of mod releases. I sought the help of several developers on stuff I had trouble on and not many could help me solve those issues proper. I will have to admit, that I am pooped out once again and will have to take a bit of a break to focus on life and recuperate.

I will be spending the next few days trying to fix issues with the mod reported, with the main issue tracker being here. I won’t be able to get the server crash fix out today, it’s a little more complicated than I expected but I’ll try and tackle it tomorrow instead. After that, development will slow, but hopefully be steady.

I have a few people to thank as well. Firstly, Direwolf20 for testing and for collaborating on getting this video released around the time the mod was released:

amadornes for working on the code and the shaders. RazzleberryFox for the portal gun model. Gigabit101 for testing. heldplayer for trying, and for listening to all my rants. euclideanspace.com for massively helping me figure out quaternions. The various others who knew I was working on this but kept it a secret. Apologies for those who I’ve left out though, and to Darkosto for dealing with my teasing.

That’s all for now. Gonna take a breather. I generally don’t respond to comments on this site, so discussion will be over here on Reddit.


– iChun


  1. Minecraft April 13, 2017 8:11 am  Reply

    Please Add Optifine Support. Thanks.

    • Haley August 26, 2018 9:47 am  Reply

      No one can add optifine support because the devs of optifine dont have their code as open source and they are dicks who dont help anyone with adding support for other mods, you should take it up with them

  2. Cucas360 April 13, 2017 8:44 am  Reply

    I love your work and ideas! A bit late but HAPPY BIRTHDAY!

  3. Anson April 13, 2017 11:42 pm  Reply

    So happy. I hope they add it to the FTB Beyond server so people don’t manually have to add it to their clients.

  4. Peekofowar April 14, 2017 8:39 am  Reply

    Oh no! We can’t shoot to the mood anymore.

    • Peekofowar April 14, 2017 8:39 am  Reply

      *Moon, not “mood”.

  5. Peekofowar April 14, 2017 8:45 am  Reply

    Mage the portal apparatus not work if you are fully submerged, removing all portals connected to the held device from the world.

    • Peekofowar April 14, 2017 8:45 am  Reply

      Typo: Make, not “Mage”.

  6. Malavek April 14, 2017 9:23 am  Reply

    Um…. cool but why did you remove half the mod?

    • Peekofowar April 14, 2017 10:45 am  Reply

      I believe he hasn’t removed anything. If I read it correctly, he’s re-making the mod, probably from scratch. It’ll be more streamlined, probably.

    • Maxis Maximov August 5, 2017 2:54 am  Reply

      Malavek ICun not deleted only half of mod, he deleted 90% of mod!

  7. Peekofowar April 14, 2017 10:51 am  Reply

    Please add a Portal Work Table that has an easy interface that makes it intuitive to modify the portal apparatus.

  8. Peekofowar April 14, 2017 11:07 am  Reply

    Could you make a configuration option that allows you to disable the cross hair when the portal apparatus’ cross hair is visible? This may give more of a Portal feel.

    • iChun April 14, 2017 6:31 pm  Reply

      “I generally don’t respond to comments on this site”

      Anyways, there are 5 dots in a + formation in Portal, which MC kinda has already, so no, not removing that.

      • Peekofowar April 15, 2017 10:06 am  Reply

        I guess I just never noticed.

      • Iwantanswers December 21, 2017 10:44 pm  Reply

        hey uh you know I was waiting for the emancipation grid to be finished but you removed it in the latest update why, you also removed everything portal except the portal gun why… why did you do that?

  9. TeslaX007 April 14, 2017 11:56 pm  Reply

    Does anyone know if portal gun 1.10.2 is compatible with Darkosto’s Invasion modpack?
    I’m just wondering how gameplay with portals might go.

  10. Biome April 16, 2017 6:54 am  Reply

    When will the new update come, i can’t wait to play this with my friends on a server. You announced it, then changed it, then changed it again, thats why i’m so confused when it will be released. would be great if you clarify it ^^
    thanks for developing the best mod ever!

  11. Sinom April 22, 2017 7:32 am  Reply

    I’m sad now xc. I was really looking forward to the antichamber mod!
    but the dimensional portals mod pretty much is the most important thing from it so thanks for releasing that! And about quarterions. Did you need them for the camera movement through the portals or positioning the portal camera in the right place and so rendering the portals in general? I really don’t remember much about them other than them being a 4 dimensional “kind” of number mainly used to calculate rotations in three-dimensional space.

  12. Sulphurous April 22, 2017 5:19 pm  Reply

    Oh my god I’ve been waiting literally 3 years for this, THANK YOU SO MUCH

    Question: Will there be Lasers/Emancipation grills again? Any planned release date?

    I’m truly ecstatic to play this update

    • Sulphurous April 22, 2017 5:23 pm  Reply

      The model is a bit skewed, will that be worked on or will there be an option to change it in the configuration files?

  13. Gammaboy45 April 24, 2017 11:20 am  Reply

    The “Speedy thing goes in, speedy thing comes out” concept only maintains about 3 blocks of height. It’s kinda’ irritating :/

  14. FriskRDGD April 27, 2017 1:57 am  Reply

    How can i customize the colors of the portals and size?

    • Gammaboy45 April 27, 2017 4:55 am  Reply

      the portals are not upgradable yet, and you can craft more devices to get new color sets. I don’t think color is modular yet, either. Most of the discussion above addresses additions yet to come.

    • Evansgaming February 11, 2018 12:04 am  Reply

      for the size drop the portal gun and use this command /entitydata @e[type=Item,r=10] {Item:{tag:{width:xx,height:yy}}}

  15. Unknown April 30, 2017 8:20 am  Reply

    portals crash real well with mac just sayin btw i am talking about the fancy portals and the see thru portals 🙁

  16. Maxis Maximov May 21, 2017 5:35 pm  Reply

    Budy, this mod is broken! There are none of previous Portal Gun mod, and my portals are like texture pack2d overviev! Can you fix this mod and add things from previous Portal Gun mod?

  17. Maxis Maximov May 22, 2017 7:25 pm  Reply

    And also, what do you need for Portal Gun, for that you can grab blocks’n stuff????????

    • Maxis Maximov May 22, 2017 7:26 pm  Reply

      Sorry, “And also, what do you need for that you grabbing blocks’n stuff????????” that’s how it must be.

  18. Maxis Maximov June 16, 2017 3:29 am  Reply

    IChun, why you’ve deleted stuff from 1.7.10 version???? It was cool, but you could make upgraded stuff from old version, can you make this and add new stuff, please????

  19. Caleb June 26, 2017 6:22 am  Reply

    Hey, Its been a while since this has been released, but everytime I open a world with the mod active it says “Minecraft ran out has ran out of memory”. Even when its the only mod active, it still says that. Any help?

  20. juangenial452 July 1, 2017 7:56 am  Reply

    Hey iChun you can make a mod with borderless square portals?

  21. Broken_Satellite July 8, 2017 11:50 pm  Reply

    The portal textures are very weird, tho, it isn’t that squared pink and black texture that means it didn’t find it, it simply looks like a terrain.png was used instead of the correct texture and had applied a blue color to it

    • Nesze August 19, 2017 2:54 am  Reply

      Go to “mod settings” -> Portal Gun -> Client Only -> then disable “Fancy Portals”, and you are good to go 🙂 I had the same problem.

  22. Zankanotachi July 24, 2017 9:41 pm  Reply

    Hello Ichun, Will it have the lasers as well as the grids of emancimations with the ballasted cubes?

  23. Creeperboy172 July 29, 2017 8:56 am  Reply

    I played an older version and it had the turrets and stuff. Where did it all go?

    • itsNotAshby September 15, 2017 5:32 pm  Reply

      iChun is remaking the mod from scratch.

  24. Soupcan July 31, 2017 11:36 am  Reply

    I like this! I hope you add some features from the older version(Turrets,Blocks,Shooting the moon,etc) we’re gonna wait! : )

  25. Soupcan July 31, 2017 11:38 am  Reply

    Also i learned how to change the portal sizes just use some kind of NBT editing program and modify the value! I’ve made a giant black hole while editing this heh. (You can also change the colors just changing the channel name)

    • FuzzyLeo September 4, 2017 3:48 am  Reply

      its not showing up in the editor

  26. TimboLP August 3, 2017 5:25 pm  Reply

    Whats with cubes, podestal and emmiters?

  27. Maxis Maximov August 5, 2017 2:52 am  Reply

    IChun pls add ALL things but updated with models and new stuff for new version of mod pls pls pls pls pls pls pls pls

  28. ethan August 24, 2017 3:10 am  Reply

    hay Ichun I need something plz add lazers back

  29. Marrento October 3, 2017 11:12 pm  Reply

    cade a versão pra 1.12.1?

  30. Byte October 20, 2017 2:28 pm  Reply

    will this be updated to 1.12.2?
    I miss the 1.7.10 days where many mods only gives you a bit of lag not like today where the biomes o plenty mod alone gives my laptop lag
    just wanted to see this mod brand new

  31. Byte October 21, 2017 11:15 pm  Reply

    I don’t see the rendering thing, it’s only blank white on daytime and dark blue at night time

  32. PLZ December 31, 2017 7:04 am  Reply

    When will 1.12.2 be out???????

  33. labcraft59 January 3, 2018 5:35 am  Reply

    I have an issue with the mod. I’m not sure if this has been patched yet, but when you make the infinite-fall scenario, you always glitch into the ground after hitting a certain speed. Also, does this mod only include the Portal guns, or does it have all of the items? I only got the guns. Plus, you should make this new mod for all versions, and fix the Material Emancipation Grill on the old mod. For me it is broken…

  34. Matheo January 11, 2018 10:17 pm  Reply

    Bahnhofstraße 21

  35. Jack January 21, 2018 6:51 pm  Reply

    How to install the portal gun mod

  36. KiddNether January 28, 2018 8:08 am  Reply

    How do I create a channel?

    • Gammaboy45 February 17, 2018 5:33 am  Reply

      This blog is actually really outdated. The 1.12.2 version can be found on his Curseforge project.

  37. Thegoldencheeze February 18, 2018 3:03 am  Reply

    hey so if you put a horse in a minecart (or a pig or any stacked rideable entity) you can grab the bottom entity and fly! 😮

  38. HazardBot February 24, 2018 3:22 am  Reply

    will this mod be updated to 1.7.10?

  39. Dodzh March 9, 2018 10:31 pm  Reply

    Happy bd Portal gun 🙂

  40. revenge March 13, 2018 2:24 pm  Reply

    Why there’s no turrets?????

  41. V1N3V1T July 8, 2018 9:11 am  Reply

    What wings mod?

  42. Noléo_105 August 23, 2018 7:52 pm  Reply

    Please create the incinerator.

  43. martim November 18, 2018 6:07 am  Reply

    Hello would like
    to know if it’s possible
    pass the gun portal items
    mod 1.2.5 for 1.7.10
    thank you

Leave a comment

Your email address will not be published. Required fields are marked *